Skip to content

Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel

Remove obsolete code and simplify implementation

Yuechen Li9f48f48ef81f
diff --git a/Aetheris.FEA.Tests/Aetheris.FEA.Tests.csproj b/Aetheris.FEA.Tests/Aetheris.FEA.Tests.csproj
index 7253dda4..7681b302 100644
--- a/Aetheris.FEA.Tests/Aetheris.FEA.Tests.csproj
+++ b/Aetheris.FEA.Tests/Aetheris.FEA.Tests.csproj
@@ -2,5 +2,5 @@
<PropertyGroup><TargetFramework>net10.0</TargetFramework><ImplicitUsings>enable</ImplicitUsings><Nullable>enable</Nullable><IsPackable>false</IsPackable></PropertyGroup>
<ItemGroup><PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" /><PackageReference Include="xunit" Version="2.9.2" /><PackageReference Include="xunit.runner.visualstudio" Version="2.8.2" /></ItemGroup>
<ItemGroup><Using Include="Xunit" /></ItemGroup>
- <ItemGroup><ProjectReference Include="..\Aetheris.FEA\Aetheris.FEA.csproj" /><ProjectReference Include="..\Aetheris.Forge.Sdk\Aetheris.Forge.Sdk.csproj" /></ItemGroup>
+ <ItemGroup><ProjectReference Include="..\Aetheris.FEA\Aetheris.FEA.csproj" /><ProjectReference Include="..\Aetheris.Forge.Host\Aetheris.Forge.Host.csproj" /></ItemGroup>
</Project>
diff --git a/Aetheris.FEA.Tests/LinearElasticM5Tests.cs b/Aetheris.FEA.Tests/LinearElasticM5Tests.cs
index 72ec2c92..dd59c576 100644
--- a/Aetheris.FEA.Tests/LinearElasticM5Tests.cs
+++ b/Aetheris.FEA.Tests/LinearElasticM5Tests.cs
@@ -5,7 +5,7 @@ using Aetheris.FEA.Analysis;
using Aetheris.Continuum.Boundaries;
using Aetheris.Continuum.Cir;
using Aetheris.Continuum.Lattice;
-using Aetheris.Forge.Sdk;
+using Aetheris.Forge.Host;
using Aetheris.Kernel.Core.Math;
namespace Aetheris.FEA.Tests;
diff --git a/Aetheris.Forge.Sdk.Tests/Aetheris.Forge.Sdk.Tests.csproj b/Aetheris.Forge.Host.Tests/Aetheris.Forge.Host.Tests.csproj
similarity index 91%
rename from Aetheris.Forge.Sdk.Tests/Aetheris.Forge.Sdk.Tests.csproj
rename to Aetheris.Forge.Host.Tests/Aetheris.Forge.Host.Tests.csproj
index efe86dd0..f88f21c6 100644
--- a/Aetheris.Forge.Sdk.Tests/Aetheris.Forge.Sdk.Tests.csproj
+++ b/Aetheris.Forge.Host.Tests/Aetheris.Forge.Host.Tests.csproj
@@ -15,7 +15,7 @@
<Using Include="Xunit" />
</ItemGroup>
<ItemGroup>
- <ProjectReference Include="..\Aetheris.Forge.Sdk\Aetheris.Forge.Sdk.csproj" />
+ <ProjectReference Include="..\Aetheris.Forge.Host\Aetheris.Forge.Host.csproj" />
<ProjectReference Include="..\Aetheris.Forge.SampleExtension\Aetheris.Forge.SampleExtension.csproj" />
<ProjectReference Include="..\Aetheris.Forge.SampleExtension.Bindings\Aetheris.Forge.SampleExtension.Bindings.csproj" />
<ProjectReference Include="..\Aetheris.Forge.Testing\Aetheris.Forge.Testing.csproj" />
diff --git a/Aetheris.Forge.Sdk.Tests/ForgeSdkM1Tests.cs b/Aetheris.Forge.Host.Tests/ForgeHostM1Tests.cs
similarity index 99%
rename from Aetheris.Forge.Sdk.Tests/ForgeSdkM1Tests.cs
rename to Aetheris.Forge.Host.Tests/ForgeHostM1Tests.cs
index 86ce33c9..6d6532fe 100644
--- a/Aetheris.Forge.Sdk.Tests/ForgeSdkM1Tests.cs
+++ b/Aetheris.Forge.Host.Tests/ForgeHostM1Tests.cs
@@ -1,14 +1,14 @@
using Aetheris.Forge.Abstractions;
using Aetheris.Forge.Extensions;
-using Aetheris.Forge.Sdk;
+using Aetheris.Forge.Host;
using Aetheris.Forge.Testing;
using MyCompany.SecretGeometry;
using MyCompany.SecretGeometry.Generated;
using Aetheris.Kernel.Firmament.FirmamentV2;
-namespace Aetheris.Forge.Sdk.Tests;
+namespace Aetheris.Forge.Host.Tests;
-public sealed class ForgeSdkM1Tests
+public sealed class ForgeHostM1Tests
{
private static readonly string ModulePath = Path.Combine(
FindRepositoryRoot(),
diff --git a/Aetheris.Forge.Sdk/Aetheris.Forge.Sdk.csproj b/Aetheris.Forge.Host/Aetheris.Forge.Host.csproj
similarity index 100%
rename from Aetheris.Forge.Sdk/Aetheris.Forge.Sdk.csproj
rename to Aetheris.Forge.Host/Aetheris.Forge.Host.csproj
diff --git a/Aetheris.Forge.Sdk/ForgeHost.cs b/Aetheris.Forge.Host/ForgeHost.cs
similarity index 93%
rename from Aetheris.Forge.Sdk/ForgeHost.cs
rename to Aetheris.Forge.Host/ForgeHost.cs
index c9dbed7a..440dfdbe 100644
--- a/Aetheris.Forge.Sdk/ForgeHost.cs
+++ b/Aetheris.Forge.Host/ForgeHost.cs
@@ -17,7 +17,7 @@ using Aetheris.FEA.Abaqus;
using Aetheris.FEA.Firmament;
using Aetheris.FEA.Mechanics;
-namespace Aetheris.Forge.Sdk;
+namespace Aetheris.Forge.Host;
public sealed class ForgeHost
{
@@ -92,15 +92,7 @@ public sealed class ForgeHost
diagnostics.AddRange(bindDiagnostics);
if (bindDiagnostics.Count > 0) return Failure(diagnostics);
- var hostArguments = invocation.Bindings.ToDictionary(
- pair => pair.Key,
- pair => pair.Value is ForgeRecord record
- ? new FirmamentHostArgument(
- record.RecordType,
- record.RecordType,
- record.Fields.ToDictionary(field => field.Key, field => field.Value.CanonicalLiteral, StringComparer.Ordinal))
- : new FirmamentHostArgument(pair.Value.CanonicalLiteral),
- StringComparer.Ordinal);
+ var hostArguments = invocation.Bindings.ToDictionary(pair => pair.Key, pair => ToHostArgument(pair.Value), StringComparer.Ordinal);
var invocationStart = Stopwatch.GetTimestamp();
var expansion = FirmamentTemplateHostBridge.Expand(
invocation.Module.Source,
@@ -202,7 +194,7 @@ public sealed class ForgeHost
new ForgeProvenanceEntry("capability", descriptor.Id.Value, $"{descriptor.ExtensionId}@{descriptor.ExtensionVersion};{descriptor.ProvenanceIdentity}"),
new ForgeProvenanceEntry("construction", execution.Output.Construction?.SourceIdentity ?? "exact-brep", execution.Output.Construction?.SemanticRegionIdentity ?? construct.InstanceName),
new ForgeProvenanceEntry("artifact", construct.InstanceName, "STEP AP242 export and reimport validated"),
- };
+ }.Concat(invocation.Provenance).ToArray();
var hash = ArtifactHash(exported.Value, expansion.SpecializationIdentity, [capabilityEvidence], provenance);
return new ForgeCompilationResult(
new ForgeCompilationArtifact(exported.Value, hash, body, cir, [capabilityEvidence], provenance,
@@ -212,7 +204,7 @@ public sealed class ForgeHost
resolutionTime,
invocationTime,
extensionTime,
- compilerTime);
+ compilerTime) { TemplateSpecializationIdentity = expansion.SpecializationIdentity };
}
internal ForgeAnalysisInvocationResult Analyze(ForgeInvocation invocation, MechanicsSolveOptions? options)
@@ -226,11 +218,7 @@ public sealed class ForgeHost
diagnostics.Add(Error("forge-analysis-resource-missing", $"Template parameter '{binding.Key}' refers to a missing ImportedStep resource.", invocation.Module.SourcePath));
if (diagnostics.Any(item => item.Severity == ForgeDiagnosticSeverity.Error))
return new(null, null, null, diagnostics, TimeSpan.Zero, TimeSpan.Zero);
- var hostArguments = invocation.Bindings.ToDictionary(
- pair => pair.Key,
- pair => pair.Value is ForgeRecord record
- ? new FirmamentHostArgument(record.RecordType, record.RecordType, record.Fields.ToDictionary(field => field.Key, field => field.Value.CanonicalLiteral, StringComparer.Ordinal))
- : new FirmamentHostArgument(pair.Value.CanonicalLiteral), StringComparer.Ordinal);
+ var hostArguments = invocation.Bindings.ToDictionary(pair => pair.Key, pair => ToHostArgument(pair.Value), StringComparer.Ordinal);
var started = Stopwatch.GetTimestamp();
var expansion = FirmamentTemplateHostBridge.Expand(invocation.Module.Source, invocation.Template.Metadata.Name, invocation.InstanceName, hostArguments, out var expansionDiagnostics);
var invocationTime = Stopwatch.GetElapsedTime(started);
@@ -274,7 +262,7 @@ public sealed class ForgeHost
new ForgeProvenanceEntry("host", invocation.Module.SourcePath ?? invocation.Module.Name, invocation.InstanceName),
new ForgeProvenanceEntry("template", invocation.Template.Metadata.Name, expansion.SpecializationIdentity + ";record-arguments=" + string.Join(",", expansion.RecordArguments.Keys.Order(StringComparer.Ordinal))),
new ForgeProvenanceEntry("artifact", result.Value.ExportedFeatureId, result.Value.ExportedFeatureKind ?? result.Value.ExportedBodyCategory),
- };
+ }.Concat(invocation.Provenance).ToArray();
var hash = ArtifactHash(result.Value.StepText, expansion.SpecializationIdentity, [], provenance);
return new ForgeCompilationResult(
new ForgeCompilationArtifact(result.Value.StepText, hash, null, null, [], provenance),
@@ -283,7 +271,7 @@ public sealed class ForgeHost
TimeSpan.Zero,
invocationTime,
TimeSpan.Zero,
- compilerTime);
+ compilerTime) { TemplateSpecializationIdentity = expansion.SpecializationIdentity };
}
private static IReadOnlyList<ForgeDiagnostic> ValidateTemplateBindings(ForgeInvocation invocation)
@@ -306,6 +294,28 @@ public sealed class ForgeHost
return diagnostics;
}
+ private static FirmamentHostArgument ToHostArgument(ForgeValue value)
+ {
+ if (value is not ForgeRecord record) return new FirmamentHostArgument(value.CanonicalLiteral);
+ var fields = new Dictionary<string, string>(StringComparer.Ordinal);
+ Add(record, string.Empty);
+ return new FirmamentHostArgument(record.RecordType, record.RecordType, fields);
+
+ void Add(ForgeRecord current, string prefix)
+ {
+ foreach (var field in current.Fields.OrderBy(pair => pair.Key, StringComparer.Ordinal))
+ {
+ var path = prefix + field.Key;
+ if (field.Value is ForgeRecord nested)
+ {
+ fields[path] = nested.RecordType;
+ Add(nested, path + ".");
+ }
+ else fields[path] = field.Value.CanonicalLiteral;
+ }
+ }
+ }
+
private static ForgeCapabilityArguments? BindCapabilityArguments(
ForgeCapabilityDescriptorV1 descriptor,
ForgeConstruct construct,
@@ -457,6 +467,7 @@ public sealed class ForgeInvocation
{
private readonly Dictionary<string, ForgeValue> bindings = new(StringComparer.Ordinal);
private readonly Dictionary<string, ForgeResource> resources = new(StringComparer.Ordinal);
+ private readonly List<ForgeProvenanceEntry> provenance = [];
internal ForgeInvocation(ForgeHost host, ForgeModule module, ForgeTemplate template, string instanceName)
{
ArgumentException.ThrowIfNullOrWhiteSpace(instanceName);
@@ -468,9 +479,18 @@ public sealed class ForgeInvocation
public string InstanceName { get; }
internal IReadOnlyDictionary<string, ForgeValue> Bindings => bindings;
internal IReadOnlyDictionary<string, ForgeResource> Resources => resources;
+ internal IReadOnlyList<ForgeProvenanceEntry> Provenance => provenance;
internal IReadOnlySet<ForgeLoweringTarget> RequestedTargets { get; private set; } = new HashSet<ForgeLoweringTarget> { ForgeLoweringTarget.Brep };
public ForgeInvocation Bind(string name, ForgeValue value) { ArgumentNullException.ThrowIfNull(value); bindings[name] = value; return this; }
public ForgeInvocation AddResource(ForgeResource resource) { ArgumentNullException.ThrowIfNull(resource); resources[resource.Name] = resource; return this; }
+ public ForgeInvocation WithProvenance(string stage, string identity, string evidence)
+ {
+ ArgumentException.ThrowIfNullOrWhiteSpace(stage);
+ ArgumentException.ThrowIfNullOrWhiteSpace(identity);
+ ArgumentException.ThrowIfNullOrWhiteSpace(evidence);
+ provenance.Add(new ForgeProvenanceEntry(stage, identity, evidence));
+ return this;
+ }
public ForgeInvocation WithTargets(params ForgeLoweringTarget[] targets) { RequestedTargets = targets.ToHashSet(); return this; }
public ForgeCompilationResult Compile() => Host.Compile(this);
public ForgeAnalysisInvocationResult Analyze(MechanicsSolveOptions? options = null) => Host.Analyze(this, options);
diff --git a/Aetheris.Forge.Sdk/ForgeSdkModels.cs b/Aetheris.Forge.Host/ForgeHostModels.cs
similarity index 96%
rename from Aetheris.Forge.Sdk/ForgeSdkModels.cs
rename to Aetheris.Forge.Host/ForgeHostModels.cs
index 404ce25b..acee0d89 100644
--- a/Aetheris.Forge.Sdk/ForgeSdkModels.cs
+++ b/Aetheris.Forge.Host/ForgeHostModels.cs
@@ -7,7 +7,7 @@ using Aetheris.FEA.Analysis;
using Aetheris.FEA.Mechanics;
using Aetheris.Semantics;
-namespace Aetheris.Forge.Sdk;
+namespace Aetheris.Forge.Host;
public sealed record ForgeDiagnostic(
string Code,
@@ -63,6 +63,7 @@ public sealed record ForgeCompilationResult(
TimeSpan CompilerLoweringTime)
{
public bool IsSuccess => Artifact is not null && Diagnostics.All(diagnostic => diagnostic.Severity != ForgeDiagnosticSeverity.Error);
+ public string? TemplateSpecializationIdentity { get; init; }
}
public sealed record ForgeAnalysisInvocationResult(
diff --git a/Aetheris.Forge.Sdk/ForgeValues.cs b/Aetheris.Forge.Host/ForgeValues.cs
similarity index 57%
rename from Aetheris.Forge.Sdk/ForgeValues.cs
rename to Aetheris.Forge.Host/ForgeValues.cs
index 5536ed70..8f293134 100644
--- a/Aetheris.Forge.Sdk/ForgeValues.cs
+++ b/Aetheris.Forge.Host/ForgeValues.cs
@@ -1,12 +1,26 @@
using System.Globalization;
-namespace Aetheris.Forge.Sdk;
+namespace Aetheris.Forge.Host;
public abstract record ForgeValue(string TypeName)
{
internal abstract string CanonicalLiteral { get; }
+
+ public static ForgeValue From(int value) => new ForgeInteger(value);
+ public static ForgeValue From(double value) => new ForgeReal(value);
+ public static ForgeValue From(bool value) => new ForgeBoolean(value);
+ public static ForgeValue From(string value) => new ForgeString(value);
+ public static ForgeValue From(Length value) => new ForgeLength(value.Millimeters);
+ public static ForgeValue From(Angle value) => new ForgeAngle(value.Degrees);
+ public static ForgeValue From(Version value) => new ForgeVersion(value);
}
+/// <summary>An application-side length expressed explicitly in millimetres.</summary>
+public readonly record struct Length(double Millimeters);
+
+/// <summary>An application-side angle expressed explicitly in degrees.</summary>
+public readonly record struct Angle(double Degrees);
+
public sealed record ForgeLength(double Millimeters) : ForgeValue("Length")
{
internal override string CanonicalLiteral => Millimeters.ToString("R", CultureInfo.InvariantCulture) + "mm";
@@ -37,6 +51,11 @@ public sealed record ForgeString(string Value) : ForgeValue("String")
internal override string CanonicalLiteral => "\"" + Value.Replace("\\", "\\\\", StringComparison.Ordinal).Replace("\"", "\\\"", StringComparison.Ordinal) + "\"";
}
+public sealed record ForgeVersion(Version Value) : ForgeValue("Version")
+{
+ internal override string CanonicalLiteral => Value.ToString();
+}
+
public sealed record ForgeType(string Name) : ForgeValue("Type")
{
internal override string CanonicalLiteral => Name;
@@ -53,6 +72,37 @@ public sealed record ForgeRecord(string RecordType, IReadOnlyDictionary<string,
internal override string CanonicalLiteral => RecordType;
}
+/// <summary>
+/// Explicit, reflection-free mapping from an application record/DTO to a
+/// Firmament Record value. Field insertion is canonicalized by ordinal name.
+/// </summary>
+public sealed class ForgeRecordDescriptor<T>
+{
+ private readonly IReadOnlyDictionary<string, Func<T, ForgeValue>> fields;
+
+ public ForgeRecordDescriptor(string recordType, IReadOnlyDictionary<string, Func<T, ForgeValue>> fields)
+ {
+ ArgumentException.ThrowIfNullOrWhiteSpace(recordType);
+ ArgumentNullException.ThrowIfNull(fields);
+ if (fields.Count == 0) throw new ArgumentException("At least one Record field mapping is required.", nameof(fields));
+ if (fields.Keys.Any(string.IsNullOrWhiteSpace)) throw new ArgumentException("Record field names cannot be blank.", nameof(fields));
+ RecordType = recordType;
+ this.fields = fields.OrderBy(pair => pair.Key, StringComparer.Ordinal)
+ .ToDictionary(pair => pair.Key, pair => pair.Value, StringComparer.Ordinal);
+ }
+
+ public string RecordType { get; }
+
+ public ForgeRecord Map(T value)
+ {
+ ArgumentNullException.ThrowIfNull(value);
+ return new ForgeRecord(RecordType, fields.ToDictionary(
+ pair => pair.Key,
+ pair => pair.Value(value) ?? throw new InvalidOperationException($"Mapper for field '{pair.Key}' returned null."),
+ StringComparer.Ordinal));
+ }
+}
+
public abstract record ForgeResource(string Name, string ContentHash);
public sealed record ImportedStepResource(
diff --git a/Aetheris.Forge.KernelSDK/Aetheris.Forge.KernelSDK.csproj b/Aetheris.Forge.KernelSDK/Aetheris.Forge.KernelSDK.csproj
new file mode 100644
index 00000000..b0d22aa6
--- /dev/null
+++ b/Aetheris.Forge.KernelSDK/Aetheris.Forge.KernelSDK.csproj
@@ -0,0 +1,12 @@
+<Project Sdk="Microsoft.NET.Sdk">
+ <PropertyGroup>
+ <TargetFramework>net10.0</TargetFramework>
+ <ImplicitUsings>enable</ImplicitUsings>
+ <Nullable>enable</Nullable>
+ <Description>Advanced Forge kernel, semantic, compiler-capability, and extension authoring SDK.</Description>
+ </PropertyGroup>
+ <ItemGroup>
+ <ProjectReference Include="..\Aetheris.Forge\Aetheris.Forge.csproj" />
+ <ProjectReference Include="..\Aetheris.Forge.Host\Aetheris.Forge.Host.csproj" />
+ </ItemGroup>
+</Project>
diff --git a/Aetheris.Forge.KernelSDK/KernelSdk.cs b/Aetheris.Forge.KernelSDK/KernelSdk.cs
new file mode 100644
index 00000000..a797e35b
--- /dev/null
+++ b/Aetheris.Forge.KernelSDK/KernelSdk.cs
@@ -0,0 +1,11 @@
+namespace Aetheris.Forge.KernelSDK;
+
+/// <summary>
+/// Identifies the advanced Forge extension-authoring SDK. Product configurators
+/// that only invoke existing Firmament Templates should reference
+/// Aetheris.Forge.Host instead.
+/// </summary>
+public static class KernelSdk
+{
+ public const string MigrationFrom = "Aetheris.Forge.Sdk";
+}
diff --git a/Aetheris.Forge.SampleExtension.Bindings/Aetheris.Forge.SampleExtension.Bindings.csproj b/Aetheris.Forge.SampleExtension.Bindings/Aetheris.Forge.SampleExtension.Bindings.csproj
index 8cb1e722..4aeeb085 100644
--- a/Aetheris.Forge.SampleExtension.Bindings/Aetheris.Forge.SampleExtension.Bindings.csproj
+++ b/Aetheris.Forge.SampleExtension.Bindings/Aetheris.Forge.SampleExtension.Bindings.csproj
@@ -5,7 +5,7 @@
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
- <ProjectReference Include="..\Aetheris.Forge.Sdk\Aetheris.Forge.Sdk.csproj" />
+ <ProjectReference Include="..\Aetheris.Forge.Host\Aetheris.Forge.Host.csproj" />
<ProjectReference Include="..\Aetheris.Forge.SampleExtension\Aetheris.Forge.SampleExtension.csproj" />
</ItemGroup>
</Project>
diff --git a/Aetheris.Forge.SampleExtension.Bindings/ForgeTemplates.g.cs b/Aetheris.Forge.SampleExtension.Bindings/ForgeTemplates.g.cs
index b4cae557..1e12026d 100644
--- a/Aetheris.Forge.SampleExtension.Bindings/ForgeTemplates.g.cs
+++ b/Aetheris.Forge.SampleExtension.Bindings/ForgeTemplates.g.cs
@@ -1,4 +1,4 @@
-using Aetheris.Forge.Sdk;
+using Aetheris.Forge.Host;
namespace MyCompany.SecretGeometry.Generated;
diff --git a/Aetheris.Forge.SampleExtension/Aetheris.Forge.SampleExtension.csproj b/Aetheris.Forge.SampleExtension/Aetheris.Forge.SampleExtension.csproj
index f82bf369..d1426e9b 100644
--- a/Aetheris.Forge.SampleExtension/Aetheris.Forge.SampleExtension.csproj
+++ b/Aetheris.Forge.SampleExtension/Aetheris.Forge.SampleExtension.csproj
@@ -5,7 +5,7 @@
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
- <ProjectReference Include="..\Aetheris.Forge\Aetheris.Forge.csproj" />
+ <ProjectReference Include="..\Aetheris.Forge.KernelSDK\Aetheris.Forge.KernelSDK.csproj" />
</ItemGroup>
<ItemGroup>
<None Include="Templates\SecretGeometry.firmament" Pack="true" PackagePath="contentFiles\any\any\Templates" />
diff --git a/Aetheris.Forge.Testing/Aetheris.Forge.Testing.csproj b/Aetheris.Forge.Testing/Aetheris.Forge.Testing.csproj
index 45e92569..eaa9063d 100644
--- a/Aetheris.Forge.Testing/Aetheris.Forge.Testing.csproj
+++ b/Aetheris.Forge.Testing/Aetheris.Forge.Testing.csproj
@@ -5,6 +5,6 @@
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
- <ProjectReference Include="..\Aetheris.Forge.Sdk\Aetheris.Forge.Sdk.csproj" />
+ <ProjectReference Include="..\Aetheris.Forge.Host\Aetheris.Forge.Host.csproj" />
</ItemGroup>
</Project>
diff --git a/Aetheris.Forge.Testing/ForgeExtensionAssertions.cs b/Aetheris.Forge.Testing/ForgeExtensionAssertions.cs
index eb86e1d8..b74a6c04 100644
--- a/Aetheris.Forge.Testing/ForgeExtensionAssertions.cs
+++ b/Aetheris.Forge.Testing/ForgeExtensionAssertions.cs
@@ -1,4 +1,4 @@
-using Aetheris.Forge.Sdk;
+using Aetheris.Forge.Host;
using Aetheris.Kernel.Core.Brep;
using Aetheris.Kernel.Core.Step242;
diff --git a/Aetheris.slnx b/Aetheris.slnx
index e5a3a940..b4b0a1bb 100644
--- a/Aetheris.slnx
+++ b/Aetheris.slnx
@@ -18,11 +18,14 @@
<Project Path="tools/Aetheris.Continuum.AttentionE0/Aetheris.Continuum.AttentionE0.csproj" />
<Project Path="tools/Aetheris.Continuum.AttentionE1/Aetheris.Continuum.AttentionE1.csproj" />
<Project Path="Aetheris.Forge/Aetheris.Forge.csproj" />
- <Project Path="Aetheris.Forge.Sdk/Aetheris.Forge.Sdk.csproj" />
+ <Project Path="Aetheris.Forge.Host/Aetheris.Forge.Host.csproj" />
+ <Project Path="Aetheris.Forge.KernelSDK/Aetheris.Forge.KernelSDK.csproj" />
<Project Path="Aetheris.Forge.SampleExtension/Aetheris.Forge.SampleExtension.csproj" />
<Project Path="Aetheris.Forge.SampleExtension.Bindings/Aetheris.Forge.SampleExtension.Bindings.csproj" />
<Project Path="Aetheris.Forge.Testing/Aetheris.Forge.Testing.csproj" />
- <Project Path="Aetheris.Forge.Sdk.Tests/Aetheris.Forge.Sdk.Tests.csproj" />
+ <Project Path="Aetheris.Forge.Host.Tests/Aetheris.Forge.Host.Tests.csproj" />
+ <Project Path="samples/Aetheris.Samples.DatabaseDrivenCad/Aetheris.Samples.DatabaseDrivenCad.csproj" />
+ <Project Path="samples/Aetheris.Samples.DatabaseDrivenCad.Tests/Aetheris.Samples.DatabaseDrivenCad.Tests.csproj" />
<Project Path="Aetheris.Kernel.StandardLibrary/Aetheris.Kernel.StandardLibrary.csproj" />
<Project Path="Aetheris.Kernel.Firmament/Aetheris.Kernel.Firmament.csproj" />
<Project Path="Aetheris.Kernel.Firmament.Tests/Aetheris.Kernel.Firmament.Tests.csproj" />
diff --git a/docs/audits/forge-a0-semantic-extension-architecture-audit.md b/docs/audits/forge-a0-semantic-extension-architecture-audit.md
index 63e9aa4e..f30dc457 100644
--- a/docs/audits/forge-a0-semantic-extension-architecture-audit.md
+++ b/docs/audits/forge-a0-semantic-extension-architecture-audit.md
@@ -176,7 +176,7 @@ Aetheris.Forge.Abstractions
package identity/version/host requirements
examples/fixtures/LLM guidance metadata
-Aetheris.Forge.Sdk
+Aetheris.Forge.KernelSDK
Authoring and conformance helpers:
descriptor builders
schema validation
@@ -212,7 +212,7 @@ Third-party Forge packages
Important dependency direction:
- `Aetheris.Forge.Abstractions` must be small and stable.
-- `Aetheris.Forge.Sdk` can depend on test/utilities but should not be required by the runtime kernel path.
+- `Aetheris.Forge.KernelSDK` can depend on test/utilities but should not be required by the runtime kernel path.
- `Aetheris.StandardLibrary` should become a semantic pack over the abstractions, not a BRep helper project that depends on arbitrary Forge geometry helpers.
- Runtime hosts should consume descriptors and declared capabilities, not discover and execute arbitrary package code by default.
diff --git a/docs/forge/architecture.md b/docs/forge/architecture.md
index ff1dd4f4..227b78b9 100644
--- a/docs/forge/architecture.md
+++ b/docs/forge/architecture.md
@@ -30,17 +30,22 @@ Aetheris.Forge extension contracts and standard ConstructionI
Aetheris.Kernel.Firmament typed Template binder and compiler
^
|
-Aetheris.Forge.Sdk C# host embedding, capability dispatch, artifact/provenance access
+Aetheris.Forge.Host ordinary C# Template invocation and artifact/provenance access
^
+-- Aetheris.Forge.Testing
+-- generated binding packages / host applications
-Aetheris.Forge.SampleExtension --> Aetheris.Forge only
+Aetheris.Forge.KernelSDK advanced extension-author dependency facade
+ ^
+ |
+Aetheris.Forge.SampleExtension
```
-The existing `Aetheris.Forge` assembly remains below Firmament because Firmament already consumes its concept contracts. Putting `ForgeHost` into that assembly would create a dependency cycle. `Aetheris.Forge.Sdk` is the sanctioned compiler-facing package while `Aetheris.Forge` remains the low-level extension-contract package.
+The existing `Aetheris.Forge` assembly remains below Firmament because Firmament already consumes its concept contracts. Putting `ForgeHost` into that assembly would create a dependency cycle. `Aetheris.Forge.Host` is the sanctioned compiler-facing package while `Aetheris.Forge` remains the low-level extension-contract package.
+
+`Aetheris.Forge.Host` is the supported dependency for ordinary applications that invoke existing Templates. `Aetheris.Forge.KernelSDK` is the explicit advanced dependency for packages that implement construction, semantic, or compiler capabilities. If you only want to invoke existing Templates or Concepts from C#, you should not depend on KernelSDK.
-The sample extension depends only on `Aetheris.Forge` and public Kernel contracts reached through it. It receives no `InternalsVisibleTo` access and contains no capability-specific Kernel code.
+The sample extension depends on `Aetheris.Forge.KernelSDK` and public contracts reached through it. It receives no `InternalsVisibleTo` access and contains no capability-specific Kernel code.
## Compilation model
diff --git a/docs/forge/artifacts/host-m2/dependency-graph.txt b/docs/forge/artifacts/host-m2/dependency-graph.txt
new file mode 100644
index 00000000..288e36d2
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/dependency-graph.txt
@@ -0,0 +1,21 @@
+Direct project dependency:
+ Aetheris.Samples.DatabaseDrivenCad -> Aetheris.Forge.Host
+
+Resolved Aetheris libraries:
+ Aetheris.Continuum/2.0.0-preview.1
+ Aetheris.FEA/2.0.0-preview.1
+ Aetheris.Forge.Host/2.0.0-preview.1
+ Aetheris.Forge/2.0.0-preview.1
+ Aetheris.Kernel.Core/2.0.0-preview.1
+ Aetheris.Kernel.Firmament/2.0.0-preview.1
+ Aetheris.Kernel.StandardLibrary/2.0.0-preview.1
+ Aetheris.Semantics/2.0.0-preview.1
+
+Aetheris.Forge.KernelSDK direct: NO
+Aetheris.Forge.KernelSDK transitive: NO
+
+SQLite stack:
+ Microsoft.EntityFrameworkCore.Sqlite/10.0.0
+ Microsoft.Data.Sqlite.Core/10.0.0
+ SQLitePCLRaw.bundle_e_sqlite3/3.0.5
+ SQLite/3.53.4
diff --git a/docs/forge/artifacts/host-m2/package-audit.md b/docs/forge/artifacts/host-m2/package-audit.md
new file mode 100644
index 00000000..c710a251
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/package-audit.md
@@ -0,0 +1,21 @@
+# Forge Host M2 package and API audit
+
+## Prior state
+
+| Surface | Prior classification | Finding |
+|---|---|---|
+| `Aetheris.Forge` | kernel/extension contracts | Below Firmament; owns descriptors, concept packs, extension registry/executor contracts, and standard capabilities. Moving compiler hosting here would create a dependency cycle. |
+| `Aetheris.Forge.Sdk` | mixed ordinary host and advanced extension use | Owned `ForgeHost`, module/template/invocation/result, typed values, extension registration, resource/analysis paths, and capability dispatch. The name did not identify an audience. |
+| generated SecretGeometry bindings | sample/generated proof | Strongly typed but referenced the ambiguous SDK. |
+| SecretGeometry extension/manifests | advanced sample | A real private capability and manifest proof, not ordinary configurator API. |
+| CLI integration | application host | Compiles and inspects real Firmament/AP242, but is file/source oriented rather than the typed application binding seam. |
+
+## Decision
+
+- `Aetheris.Forge.Host` owns the existing supported compiler-facing host path: module inspection, direct binder/IR Template arguments, diagnostics, compilation results, specialization identity, provenance, resources, and artifacts.
+- `Aetheris.Forge.KernelSDK` is the explicit advanced extension-author dependency and references Host plus the low-level Forge contracts.
+- `Aetheris.Forge` remains below Firmament because its contracts are compiler dependencies. It is not advertised as the ordinary application entry point.
+- `Aetheris.Forge.Sdk` is removed. No compatibility forwarder is justified before a stable package release.
+- SecretGeometry's extension implementation now references KernelSDK; its generated consumer binding references Host.
+
+The database sample references Host only. KernelSDK is absent from both direct and transitive restore graphs.
diff --git a/docs/forge/artifacts/host-m2/run/batch-a/AB-204/AB-204.step b/docs/forge/artifacts/host-m2/run/batch-a/AB-204/AB-204.step
new file mode 100644
index 00000000..10fe4dae
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/batch-a/AB-204/AB-204.step
@@ -0,0 +1,215 @@
+ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('Aetheris AP242 subset export'),'2;1');
+FILE_NAME('aetheris_export.step','1970-01-01T00:00:00',('Aetheris'),('Aetheris'),'Aetheris.Kernel','Aetheris.Kernel','');
+FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));
+ENDSEC;
+DATA;
+#1=CARTESIAN_POINT($,(0,0,0));
+#2=DIRECTION($,(0,0,-1));
+#3=DIRECTION($,(1,0,0));
+#4=AXIS2_PLACEMENT_3D($,#1,#2,#3);
+#5=PLANE($,#4);
+#6=CARTESIAN_POINT($,(-50,-30,-0));
+#7=VERTEX_POINT($,#6);
+#8=CARTESIAN_POINT($,(50,-30,-0));
+#9=VERTEX_POINT($,#8);
+#10=CARTESIAN_POINT($,(-50,-30,-0));
+#11=DIRECTION($,(1,0,0));
+#12=VECTOR($,#11,1);
+#13=LINE($,#10,#12);
+#14=EDGE_CURVE($,#7,#9,#13,.T.);
+#15=ORIENTED_EDGE($,$,$,#14,.T.);
+#16=CARTESIAN_POINT($,(50,30,-0));
+#17=VERTEX_POINT($,#16);
+#18=CARTESIAN_POINT($,(50,-30,-0));
+#19=DIRECTION($,(0,1,0));
+#20=VECTOR($,#19,1);
+#21=LINE($,#18,#20);
+#22=EDGE_CURVE($,#9,#17,#21,.T.);
+#23=ORIENTED_EDGE($,$,$,#22,.T.);
+#24=CARTESIAN_POINT($,(-50,30,-0));
+#25=VERTEX_POINT($,#24);
+#26=CARTESIAN_POINT($,(50,30,-0));
+#27=DIRECTION($,(-1,0,0));
+#28=VECTOR($,#27,1);
+#29=LINE($,#26,#28);
+#30=EDGE_CURVE($,#17,#25,#29,.T.);
+#31=ORIENTED_EDGE($,$,$,#30,.T.);
+#32=CARTESIAN_POINT($,(-50,30,-0));
+#33=DIRECTION($,(0,-1,0));
+#34=VECTOR($,#33,1);
+#35=LINE($,#32,#34);
+#36=EDGE_CURVE($,#25,#7,#35,.T.);
+#37=ORIENTED_EDGE($,$,$,#36,.T.);
+#38=EDGE_LOOP($,(#15,#23,#31,#37));
+#39=FACE_OUTER_BOUND('',#38,.T.);
+#40=CARTESIAN_POINT($,(12,0,0));
+#41=VERTEX_POINT($,#40);
+#42=CARTESIAN_POINT($,(0,0,0));
+#43=DIRECTION($,(0,0,1));
+#44=DIRECTION($,(1,0,0));
+#45=AXIS2_PLACEMENT_3D($,#42,#43,#44);
+#46=CIRCLE($,#45,12);
+#47=EDGE_CURVE($,#41,#41,#46,.T.);
+#48=ORIENTED_EDGE($,$,$,#47,.F.);
+#49=EDGE_LOOP($,(#48));
+#50=FACE_BOUND('',#49,.T.);
+#51=ADVANCED_FACE('',(#39,#50),#5,.T.);
+#52=CARTESIAN_POINT($,(0,0,16));
+#53=DIRECTION($,(0,0,1));
+#54=DIRECTION($,(1,0,0));
+#55=AXIS2_PLACEMENT_3D($,#52,#53,#54);
+#56=PLANE($,#55);
+#57=CARTESIAN_POINT($,(-50,-30,16));
+#58=VERTEX_POINT($,#57);
+#59=CARTESIAN_POINT($,(50,-30,16));
+#60=VERTEX_POINT($,#59);
+#61=CARTESIAN_POINT($,(-50,-30,16));
+#62=DIRECTION($,(1,0,0));
+#63=VECTOR($,#62,1);
+#64=LINE($,#61,#63);
+#65=EDGE_CURVE($,#58,#60,#64,.T.);
+#66=ORIENTED_EDGE($,$,$,#65,.T.);
+#67=CARTESIAN_POINT($,(50,30,16));
+#68=VERTEX_POINT($,#67);
+#69=CARTESIAN_POINT($,(50,-30,16));
+#70=DIRECTION($,(0,1,0));
+#71=VECTOR($,#70,1);
+#72=LINE($,#69,#71);
+#73=EDGE_CURVE($,#60,#68,#72,.T.);
+#74=ORIENTED_EDGE($,$,$,#73,.T.);
+#75=CARTESIAN_POINT($,(-50,30,16));
+#76=VERTEX_POINT($,#75);
+#77=CARTESIAN_POINT($,(50,30,16));
+#78=DIRECTION($,(-1,0,0));
+#79=VECTOR($,#78,1);
+#80=LINE($,#77,#79);
+#81=EDGE_CURVE($,#68,#76,#80,.T.);
+#82=ORIENTED_EDGE($,$,$,#81,.T.);
+#83=CARTESIAN_POINT($,(-50,30,16));
+#84=DIRECTION($,(0,-1,0));
+#85=VECTOR($,#84,1);
+#86=LINE($,#83,#85);
+#87=EDGE_CURVE($,#76,#58,#86,.T.);
+#88=ORIENTED_EDGE($,$,$,#87,.T.);
+#89=EDGE_LOOP($,(#66,#74,#82,#88));
+#90=FACE_OUTER_BOUND('',#89,.T.);
+#91=CARTESIAN_POINT($,(12,0,16));
+#92=VERTEX_POINT($,#91);
+#93=CARTESIAN_POINT($,(0,0,16));
+#94=DIRECTION($,(0,0,1));
+#95=DIRECTION($,(1,0,0));
+#96=AXIS2_PLACEMENT_3D($,#93,#94,#95);
+#97=CIRCLE($,#96,12);
+#98=EDGE_CURVE($,#92,#92,#97,.T.);
+#99=ORIENTED_EDGE($,$,$,#98,.T.);
+#100=EDGE_LOOP($,(#99));
+#101=FACE_BOUND('',#100,.T.);
+#102=ADVANCED_FACE('',(#90,#101),#56,.T.);
+#103=CARTESIAN_POINT($,(0,-30,0));
+#104=DIRECTION($,(0,-1,0));
+#105=DIRECTION($,(1,0,0));
+#106=AXIS2_PLACEMENT_3D($,#103,#104,#105);
+#107=PLANE($,#106);
+#108=ORIENTED_EDGE($,$,$,#14,.T.);
+#109=CARTESIAN_POINT($,(50,-30,-0));
+#110=DIRECTION($,(0,0,1));
+#111=VECTOR($,#110,1);
+#112=LINE($,#109,#111);
+#113=EDGE_CURVE($,#9,#60,#112,.T.);
+#114=ORIENTED_EDGE($,$,$,#113,.T.);
+#115=ORIENTED_EDGE($,$,$,#65,.F.);
+#116=CARTESIAN_POINT($,(-50,-30,-0));
+#117=DIRECTION($,(0,0,1));
+#118=VECTOR($,#117,1);
+#119=LINE($,#116,#118);
+#120=EDGE_CURVE($,#7,#58,#119,.T.);
+#121=ORIENTED_EDGE($,$,$,#120,.F.);
+#122=EDGE_LOOP($,(#108,#114,#115,#121));
+#123=FACE_OUTER_BOUND('',#122,.T.);
+#124=ADVANCED_FACE('',(#123),#107,.T.);
+#125=CARTESIAN_POINT($,(50,0,0));
+#126=DIRECTION($,(1,0,0));
+#127=DIRECTION($,(0,1,0));
+#128=AXIS2_PLACEMENT_3D($,#125,#126,#127);
+#129=PLANE($,#128);
+#130=ORIENTED_EDGE($,$,$,#22,.T.);
+#131=CARTESIAN_POINT($,(50,30,-0));
+#132=DIRECTION($,(0,0,1));
+#133=VECTOR($,#132,1);
+#134=LINE($,#131,#133);
+#135=EDGE_CURVE($,#17,#68,#134,.T.);
+#136=ORIENTED_EDGE($,$,$,#135,.T.);
+#137=ORIENTED_EDGE($,$,$,#73,.F.);
+#138=ORIENTED_EDGE($,$,$,#113,.F.);
+#139=EDGE_LOOP($,(#130,#136,#137,#138));
+#140=FACE_OUTER_BOUND('',#139,.T.);
+#141=ADVANCED_FACE('',(#140),#129,.T.);
+#142=CARTESIAN_POINT($,(0,30,0));
+#143=DIRECTION($,(0,1,0));
+#144=DIRECTION($,(-1,0,0));
+#145=AXIS2_PLACEMENT_3D($,#142,#143,#144);
+#146=PLANE($,#145);
+#147=ORIENTED_EDGE($,$,$,#30,.T.);
+#148=CARTESIAN_POINT($,(-50,30,-0));
+#149=DIRECTION($,(0,0,1));
+#150=VECTOR($,#149,1);
+#151=LINE($,#148,#150);
+#152=EDGE_CURVE($,#25,#76,#151,.T.);
+#153=ORIENTED_EDGE($,$,$,#152,.T.);
+#154=ORIENTED_EDGE($,$,$,#81,.F.);
+#155=ORIENTED_EDGE($,$,$,#135,.F.);
+#156=EDGE_LOOP($,(#147,#153,#154,#155));
+#157=FACE_OUTER_BOUND('',#156,.T.);
+#158=ADVANCED_FACE('',(#157),#146,.T.);
+#159=CARTESIAN_POINT($,(-50,0,0));
+#160=DIRECTION($,(-1,0,0));
+#161=DIRECTION($,(0,1,0));
+#162=AXIS2_PLACEMENT_3D($,#159,#160,#161);
+#163=PLANE($,#162);
+#164=ORIENTED_EDGE($,$,$,#36,.T.);
+#165=ORIENTED_EDGE($,$,$,#120,.T.);
+#166=ORIENTED_EDGE($,$,$,#87,.F.);
+#167=ORIENTED_EDGE($,$,$,#152,.F.);
+#168=EDGE_LOOP($,(#164,#165,#166,#167));
+#169=FACE_OUTER_BOUND('',#168,.T.);
+#170=ADVANCED_FACE('',(#169),#163,.T.);
+#171=CARTESIAN_POINT($,(0,0,0));
+#172=DIRECTION($,(0,0,1));
+#173=DIRECTION($,(1,0,0));
+#174=AXIS2_PLACEMENT_3D($,#171,#172,#173);
+#175=CYLINDRICAL_SURFACE($,#174,12);
+#176=CARTESIAN_POINT($,(12,0,16));
+#177=VERTEX_POINT($,#176);
+#178=CARTESIAN_POINT($,(12,0,0));
+#179=VERTEX_POINT($,#178);
+#180=CARTESIAN_POINT($,(12,0,16));
+#181=DIRECTION($,(0,0,-1));
+#182=VECTOR($,#181,1);
+#183=LINE($,#180,#182);
+#184=EDGE_CURVE($,#177,#179,#183,.T.);
+#185=ORIENTED_EDGE($,$,$,#184,.T.);
+#186=ORIENTED_EDGE($,$,$,#47,.T.);
+#187=ORIENTED_EDGE($,$,$,#184,.F.);
+#188=ORIENTED_EDGE($,$,$,#98,.F.);
+#189=EDGE_LOOP($,(#185,#186,#187,#188));
+#190=FACE_OUTER_BOUND('',#189,.T.);
+#191=ADVANCED_FACE('',(#190),#175,.T.);
+#192=CLOSED_SHELL($,(#51,#102,#124,#141,#158,#170,#191));
+#193=MANIFOLD_SOLID_BREP('AetherisBody',#192);
+#194=APPLICATION_CONTEXT('mechanical design');
+#195=PRODUCT_CONTEXT('',#194,'mechanical');
+#196=PRODUCT('AETHERIS','AetherisBody','',(#195));
+#197=PRODUCT_DEFINITION_FORMATION('','',#196);
+#198=PRODUCT_DEFINITION_CONTEXT('design',#194,'design');
+#199=PRODUCT_DEFINITION('','',#197,#198);
+#200=PRODUCT_DEFINITION_SHAPE('','',#199);
+#201=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));
+#202=(NAMED_UNIT(*)PLANE_ANGLE_UNIT()SI_UNIT($,.RADIAN.));
+#203=(NAMED_UNIT(*)SI_UNIT($,.STERADIAN.)SOLID_ANGLE_UNIT());
+#204=(GEOMETRIC_REPRESENTATION_CONTEXT(3)GLOBAL_UNIT_ASSIGNED_CONTEXT((#201,#202,#203))REPRESENTATION_CONTEXT('3','3D'));
+#205=SHAPE_REPRESENTATION('AetherisBody',(#193),#204);
+#206=SHAPE_DEFINITION_REPRESENTATION(#200,#205);
+ENDSEC;
+END-ISO-10303-21;
diff --git a/docs/forge/artifacts/host-m2/run/batch-a/AB-305/AB-305.step b/docs/forge/artifacts/host-m2/run/batch-a/AB-305/AB-305.step
new file mode 100644
index 00000000..f77d66c1
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/batch-a/AB-305/AB-305.step
@@ -0,0 +1,215 @@
+ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('Aetheris AP242 subset export'),'2;1');
+FILE_NAME('aetheris_export.step','1970-01-01T00:00:00',('Aetheris'),('Aetheris'),'Aetheris.Kernel','Aetheris.Kernel','');
+FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));
+ENDSEC;
+DATA;
+#1=CARTESIAN_POINT($,(0,0,0));
+#2=DIRECTION($,(0,0,-1));
+#3=DIRECTION($,(1,0,0));
+#4=AXIS2_PLACEMENT_3D($,#1,#2,#3);
+#5=PLANE($,#4);
+#6=CARTESIAN_POINT($,(-60,-35,-0));
+#7=VERTEX_POINT($,#6);
+#8=CARTESIAN_POINT($,(60,-35,-0));
+#9=VERTEX_POINT($,#8);
+#10=CARTESIAN_POINT($,(-60,-35,-0));
+#11=DIRECTION($,(1,0,0));
+#12=VECTOR($,#11,1);
+#13=LINE($,#10,#12);
+#14=EDGE_CURVE($,#7,#9,#13,.T.);
+#15=ORIENTED_EDGE($,$,$,#14,.T.);
+#16=CARTESIAN_POINT($,(60,35,-0));
+#17=VERTEX_POINT($,#16);
+#18=CARTESIAN_POINT($,(60,-35,-0));
+#19=DIRECTION($,(0,1,0));
+#20=VECTOR($,#19,1);
+#21=LINE($,#18,#20);
+#22=EDGE_CURVE($,#9,#17,#21,.T.);
+#23=ORIENTED_EDGE($,$,$,#22,.T.);
+#24=CARTESIAN_POINT($,(-60,35,-0));
+#25=VERTEX_POINT($,#24);
+#26=CARTESIAN_POINT($,(60,35,-0));
+#27=DIRECTION($,(-1,0,0));
+#28=VECTOR($,#27,1);
+#29=LINE($,#26,#28);
+#30=EDGE_CURVE($,#17,#25,#29,.T.);
+#31=ORIENTED_EDGE($,$,$,#30,.T.);
+#32=CARTESIAN_POINT($,(-60,35,-0));
+#33=DIRECTION($,(0,-1,0));
+#34=VECTOR($,#33,1);
+#35=LINE($,#32,#34);
+#36=EDGE_CURVE($,#25,#7,#35,.T.);
+#37=ORIENTED_EDGE($,$,$,#36,.T.);
+#38=EDGE_LOOP($,(#15,#23,#31,#37));
+#39=FACE_OUTER_BOUND('',#38,.T.);
+#40=CARTESIAN_POINT($,(15,0,0));
+#41=VERTEX_POINT($,#40);
+#42=CARTESIAN_POINT($,(0,0,0));
+#43=DIRECTION($,(0,0,1));
+#44=DIRECTION($,(1,0,0));
+#45=AXIS2_PLACEMENT_3D($,#42,#43,#44);
+#46=CIRCLE($,#45,15);
+#47=EDGE_CURVE($,#41,#41,#46,.T.);
+#48=ORIENTED_EDGE($,$,$,#47,.F.);
+#49=EDGE_LOOP($,(#48));
+#50=FACE_BOUND('',#49,.T.);
+#51=ADVANCED_FACE('',(#39,#50),#5,.T.);
+#52=CARTESIAN_POINT($,(0,0,20));
+#53=DIRECTION($,(0,0,1));
+#54=DIRECTION($,(1,0,0));
+#55=AXIS2_PLACEMENT_3D($,#52,#53,#54);
+#56=PLANE($,#55);
+#57=CARTESIAN_POINT($,(-60,-35,20));
+#58=VERTEX_POINT($,#57);
+#59=CARTESIAN_POINT($,(60,-35,20));
+#60=VERTEX_POINT($,#59);
+#61=CARTESIAN_POINT($,(-60,-35,20));
+#62=DIRECTION($,(1,0,0));
+#63=VECTOR($,#62,1);
+#64=LINE($,#61,#63);
+#65=EDGE_CURVE($,#58,#60,#64,.T.);
+#66=ORIENTED_EDGE($,$,$,#65,.T.);
+#67=CARTESIAN_POINT($,(60,35,20));
+#68=VERTEX_POINT($,#67);
+#69=CARTESIAN_POINT($,(60,-35,20));
+#70=DIRECTION($,(0,1,0));
+#71=VECTOR($,#70,1);
+#72=LINE($,#69,#71);
+#73=EDGE_CURVE($,#60,#68,#72,.T.);
+#74=ORIENTED_EDGE($,$,$,#73,.T.);
+#75=CARTESIAN_POINT($,(-60,35,20));
+#76=VERTEX_POINT($,#75);
+#77=CARTESIAN_POINT($,(60,35,20));
+#78=DIRECTION($,(-1,0,0));
+#79=VECTOR($,#78,1);
+#80=LINE($,#77,#79);
+#81=EDGE_CURVE($,#68,#76,#80,.T.);
+#82=ORIENTED_EDGE($,$,$,#81,.T.);
+#83=CARTESIAN_POINT($,(-60,35,20));
+#84=DIRECTION($,(0,-1,0));
+#85=VECTOR($,#84,1);
+#86=LINE($,#83,#85);
+#87=EDGE_CURVE($,#76,#58,#86,.T.);
+#88=ORIENTED_EDGE($,$,$,#87,.T.);
+#89=EDGE_LOOP($,(#66,#74,#82,#88));
+#90=FACE_OUTER_BOUND('',#89,.T.);
+#91=CARTESIAN_POINT($,(15,0,20));
+#92=VERTEX_POINT($,#91);
+#93=CARTESIAN_POINT($,(0,0,20));
+#94=DIRECTION($,(0,0,1));
+#95=DIRECTION($,(1,0,0));
+#96=AXIS2_PLACEMENT_3D($,#93,#94,#95);
+#97=CIRCLE($,#96,15);
+#98=EDGE_CURVE($,#92,#92,#97,.T.);
+#99=ORIENTED_EDGE($,$,$,#98,.T.);
+#100=EDGE_LOOP($,(#99));
+#101=FACE_BOUND('',#100,.T.);
+#102=ADVANCED_FACE('',(#90,#101),#56,.T.);
+#103=CARTESIAN_POINT($,(0,-35,0));
+#104=DIRECTION($,(0,-1,0));
+#105=DIRECTION($,(1,0,0));
+#106=AXIS2_PLACEMENT_3D($,#103,#104,#105);
+#107=PLANE($,#106);
+#108=ORIENTED_EDGE($,$,$,#14,.T.);
+#109=CARTESIAN_POINT($,(60,-35,-0));
+#110=DIRECTION($,(0,0,1));
+#111=VECTOR($,#110,1);
+#112=LINE($,#109,#111);
+#113=EDGE_CURVE($,#9,#60,#112,.T.);
+#114=ORIENTED_EDGE($,$,$,#113,.T.);
+#115=ORIENTED_EDGE($,$,$,#65,.F.);
+#116=CARTESIAN_POINT($,(-60,-35,-0));
+#117=DIRECTION($,(0,0,1));
+#118=VECTOR($,#117,1);
+#119=LINE($,#116,#118);
+#120=EDGE_CURVE($,#7,#58,#119,.T.);
+#121=ORIENTED_EDGE($,$,$,#120,.F.);
+#122=EDGE_LOOP($,(#108,#114,#115,#121));
+#123=FACE_OUTER_BOUND('',#122,.T.);
+#124=ADVANCED_FACE('',(#123),#107,.T.);
+#125=CARTESIAN_POINT($,(60,0,0));
+#126=DIRECTION($,(1,0,0));
+#127=DIRECTION($,(0,1,0));
+#128=AXIS2_PLACEMENT_3D($,#125,#126,#127);
+#129=PLANE($,#128);
+#130=ORIENTED_EDGE($,$,$,#22,.T.);
+#131=CARTESIAN_POINT($,(60,35,-0));
+#132=DIRECTION($,(0,0,1));
+#133=VECTOR($,#132,1);
+#134=LINE($,#131,#133);
+#135=EDGE_CURVE($,#17,#68,#134,.T.);
+#136=ORIENTED_EDGE($,$,$,#135,.T.);
+#137=ORIENTED_EDGE($,$,$,#73,.F.);
+#138=ORIENTED_EDGE($,$,$,#113,.F.);
+#139=EDGE_LOOP($,(#130,#136,#137,#138));
+#140=FACE_OUTER_BOUND('',#139,.T.);
+#141=ADVANCED_FACE('',(#140),#129,.T.);
+#142=CARTESIAN_POINT($,(0,35,0));
+#143=DIRECTION($,(0,1,0));
+#144=DIRECTION($,(-1,0,0));
+#145=AXIS2_PLACEMENT_3D($,#142,#143,#144);
+#146=PLANE($,#145);
+#147=ORIENTED_EDGE($,$,$,#30,.T.);
+#148=CARTESIAN_POINT($,(-60,35,-0));
+#149=DIRECTION($,(0,0,1));
+#150=VECTOR($,#149,1);
+#151=LINE($,#148,#150);
+#152=EDGE_CURVE($,#25,#76,#151,.T.);
+#153=ORIENTED_EDGE($,$,$,#152,.T.);
+#154=ORIENTED_EDGE($,$,$,#81,.F.);
+#155=ORIENTED_EDGE($,$,$,#135,.F.);
+#156=EDGE_LOOP($,(#147,#153,#154,#155));
+#157=FACE_OUTER_BOUND('',#156,.T.);
+#158=ADVANCED_FACE('',(#157),#146,.T.);
+#159=CARTESIAN_POINT($,(-60,0,0));
+#160=DIRECTION($,(-1,0,0));
+#161=DIRECTION($,(0,1,0));
+#162=AXIS2_PLACEMENT_3D($,#159,#160,#161);
+#163=PLANE($,#162);
+#164=ORIENTED_EDGE($,$,$,#36,.T.);
+#165=ORIENTED_EDGE($,$,$,#120,.T.);
+#166=ORIENTED_EDGE($,$,$,#87,.F.);
+#167=ORIENTED_EDGE($,$,$,#152,.F.);
+#168=EDGE_LOOP($,(#164,#165,#166,#167));
+#169=FACE_OUTER_BOUND('',#168,.T.);
+#170=ADVANCED_FACE('',(#169),#163,.T.);
+#171=CARTESIAN_POINT($,(0,0,0));
+#172=DIRECTION($,(0,0,1));
+#173=DIRECTION($,(1,0,0));
+#174=AXIS2_PLACEMENT_3D($,#171,#172,#173);
+#175=CYLINDRICAL_SURFACE($,#174,15);
+#176=CARTESIAN_POINT($,(15,0,20));
+#177=VERTEX_POINT($,#176);
+#178=CARTESIAN_POINT($,(15,0,0));
+#179=VERTEX_POINT($,#178);
+#180=CARTESIAN_POINT($,(15,0,20));
+#181=DIRECTION($,(0,0,-1));
+#182=VECTOR($,#181,1);
+#183=LINE($,#180,#182);
+#184=EDGE_CURVE($,#177,#179,#183,.T.);
+#185=ORIENTED_EDGE($,$,$,#184,.T.);
+#186=ORIENTED_EDGE($,$,$,#47,.T.);
+#187=ORIENTED_EDGE($,$,$,#184,.F.);
+#188=ORIENTED_EDGE($,$,$,#98,.F.);
+#189=EDGE_LOOP($,(#185,#186,#187,#188));
+#190=FACE_OUTER_BOUND('',#189,.T.);
+#191=ADVANCED_FACE('',(#190),#175,.T.);
+#192=CLOSED_SHELL($,(#51,#102,#124,#141,#158,#170,#191));
+#193=MANIFOLD_SOLID_BREP('AetherisBody',#192);
+#194=APPLICATION_CONTEXT('mechanical design');
+#195=PRODUCT_CONTEXT('',#194,'mechanical');
+#196=PRODUCT('AETHERIS','AetherisBody','',(#195));
+#197=PRODUCT_DEFINITION_FORMATION('','',#196);
+#198=PRODUCT_DEFINITION_CONTEXT('design',#194,'design');
+#199=PRODUCT_DEFINITION('','',#197,#198);
+#200=PRODUCT_DEFINITION_SHAPE('','',#199);
+#201=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));
+#202=(NAMED_UNIT(*)PLANE_ANGLE_UNIT()SI_UNIT($,.RADIAN.));
+#203=(NAMED_UNIT(*)SI_UNIT($,.STERADIAN.)SOLID_ANGLE_UNIT());
+#204=(GEOMETRIC_REPRESENTATION_CONTEXT(3)GLOBAL_UNIT_ASSIGNED_CONTEXT((#201,#202,#203))REPRESENTATION_CONTEXT('3','3D'));
+#205=SHAPE_REPRESENTATION('AetherisBody',(#193),#204);
+#206=SHAPE_DEFINITION_REPRESENTATION(#200,#205);
+ENDSEC;
+END-ISO-10303-21;
diff --git a/docs/forge/artifacts/host-m2/run/batch-a/manifest.json b/docs/forge/artifacts/host-m2/run/batch-a/manifest.json
new file mode 100644
index 00000000..30f9f298
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/batch-a/manifest.json
@@ -0,0 +1,20 @@
+[
+ {
+ "PartNumber": "AB-204",
+ "TemplateSpecialization": "template:1d2e995f2be2e479",
+ "StepPath": "C:\\Users\\yuech\\source\\repos\\Aetheris\\docs\\forge\\artifacts\\host-m2\\run\\batch-a\\AB-204\\AB-204.step",
+ "StepSha256": "3ACD9BEA0CE21C5FDF7699A27128D8B11F05F4719C939746742AE1FC7C3F7259",
+ "Diagnostics": [],
+ "MappingMilliseconds": 4.554,
+ "CompilationMilliseconds": 252.3772
+ },
+ {
+ "PartNumber": "AB-305",
+ "TemplateSpecialization": "template:eea80ba75fd5599f",
+ "StepPath": "C:\\Users\\yuech\\source\\repos\\Aetheris\\docs\\forge\\artifacts\\host-m2\\run\\batch-a\\AB-305\\AB-305.step",
+ "StepSha256": "5764A7273643806522A13864BAF28C331D10B40C6E82FE513FB7FDEBB90BD4AF",
+ "Diagnostics": [],
+ "MappingMilliseconds": 0.0165,
+ "CompilationMilliseconds": 5.0579
+ }
+]
\ No newline at end of file
diff --git a/docs/forge/artifacts/host-m2/run/batch-b/AB-204/AB-204.step b/docs/forge/artifacts/host-m2/run/batch-b/AB-204/AB-204.step
new file mode 100644
index 00000000..10fe4dae
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/batch-b/AB-204/AB-204.step
@@ -0,0 +1,215 @@
+ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('Aetheris AP242 subset export'),'2;1');
+FILE_NAME('aetheris_export.step','1970-01-01T00:00:00',('Aetheris'),('Aetheris'),'Aetheris.Kernel','Aetheris.Kernel','');
+FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));
+ENDSEC;
+DATA;
+#1=CARTESIAN_POINT($,(0,0,0));
+#2=DIRECTION($,(0,0,-1));
+#3=DIRECTION($,(1,0,0));
+#4=AXIS2_PLACEMENT_3D($,#1,#2,#3);
+#5=PLANE($,#4);
+#6=CARTESIAN_POINT($,(-50,-30,-0));
+#7=VERTEX_POINT($,#6);
+#8=CARTESIAN_POINT($,(50,-30,-0));
+#9=VERTEX_POINT($,#8);
+#10=CARTESIAN_POINT($,(-50,-30,-0));
+#11=DIRECTION($,(1,0,0));
+#12=VECTOR($,#11,1);
+#13=LINE($,#10,#12);
+#14=EDGE_CURVE($,#7,#9,#13,.T.);
+#15=ORIENTED_EDGE($,$,$,#14,.T.);
+#16=CARTESIAN_POINT($,(50,30,-0));
+#17=VERTEX_POINT($,#16);
+#18=CARTESIAN_POINT($,(50,-30,-0));
+#19=DIRECTION($,(0,1,0));
+#20=VECTOR($,#19,1);
+#21=LINE($,#18,#20);
+#22=EDGE_CURVE($,#9,#17,#21,.T.);
+#23=ORIENTED_EDGE($,$,$,#22,.T.);
+#24=CARTESIAN_POINT($,(-50,30,-0));
+#25=VERTEX_POINT($,#24);
+#26=CARTESIAN_POINT($,(50,30,-0));
+#27=DIRECTION($,(-1,0,0));
+#28=VECTOR($,#27,1);
+#29=LINE($,#26,#28);
+#30=EDGE_CURVE($,#17,#25,#29,.T.);
+#31=ORIENTED_EDGE($,$,$,#30,.T.);
+#32=CARTESIAN_POINT($,(-50,30,-0));
+#33=DIRECTION($,(0,-1,0));
+#34=VECTOR($,#33,1);
+#35=LINE($,#32,#34);
+#36=EDGE_CURVE($,#25,#7,#35,.T.);
+#37=ORIENTED_EDGE($,$,$,#36,.T.);
+#38=EDGE_LOOP($,(#15,#23,#31,#37));
+#39=FACE_OUTER_BOUND('',#38,.T.);
+#40=CARTESIAN_POINT($,(12,0,0));
+#41=VERTEX_POINT($,#40);
+#42=CARTESIAN_POINT($,(0,0,0));
+#43=DIRECTION($,(0,0,1));
+#44=DIRECTION($,(1,0,0));
+#45=AXIS2_PLACEMENT_3D($,#42,#43,#44);
+#46=CIRCLE($,#45,12);
+#47=EDGE_CURVE($,#41,#41,#46,.T.);
+#48=ORIENTED_EDGE($,$,$,#47,.F.);
+#49=EDGE_LOOP($,(#48));
+#50=FACE_BOUND('',#49,.T.);
+#51=ADVANCED_FACE('',(#39,#50),#5,.T.);
+#52=CARTESIAN_POINT($,(0,0,16));
+#53=DIRECTION($,(0,0,1));
+#54=DIRECTION($,(1,0,0));
+#55=AXIS2_PLACEMENT_3D($,#52,#53,#54);
+#56=PLANE($,#55);
+#57=CARTESIAN_POINT($,(-50,-30,16));
+#58=VERTEX_POINT($,#57);
+#59=CARTESIAN_POINT($,(50,-30,16));
+#60=VERTEX_POINT($,#59);
+#61=CARTESIAN_POINT($,(-50,-30,16));
+#62=DIRECTION($,(1,0,0));
+#63=VECTOR($,#62,1);
+#64=LINE($,#61,#63);
+#65=EDGE_CURVE($,#58,#60,#64,.T.);
+#66=ORIENTED_EDGE($,$,$,#65,.T.);
+#67=CARTESIAN_POINT($,(50,30,16));
+#68=VERTEX_POINT($,#67);
+#69=CARTESIAN_POINT($,(50,-30,16));
+#70=DIRECTION($,(0,1,0));
+#71=VECTOR($,#70,1);
+#72=LINE($,#69,#71);
+#73=EDGE_CURVE($,#60,#68,#72,.T.);
+#74=ORIENTED_EDGE($,$,$,#73,.T.);
+#75=CARTESIAN_POINT($,(-50,30,16));
+#76=VERTEX_POINT($,#75);
+#77=CARTESIAN_POINT($,(50,30,16));
+#78=DIRECTION($,(-1,0,0));
+#79=VECTOR($,#78,1);
+#80=LINE($,#77,#79);
+#81=EDGE_CURVE($,#68,#76,#80,.T.);
+#82=ORIENTED_EDGE($,$,$,#81,.T.);
+#83=CARTESIAN_POINT($,(-50,30,16));
+#84=DIRECTION($,(0,-1,0));
+#85=VECTOR($,#84,1);
+#86=LINE($,#83,#85);
+#87=EDGE_CURVE($,#76,#58,#86,.T.);
+#88=ORIENTED_EDGE($,$,$,#87,.T.);
+#89=EDGE_LOOP($,(#66,#74,#82,#88));
+#90=FACE_OUTER_BOUND('',#89,.T.);
+#91=CARTESIAN_POINT($,(12,0,16));
+#92=VERTEX_POINT($,#91);
+#93=CARTESIAN_POINT($,(0,0,16));
+#94=DIRECTION($,(0,0,1));
+#95=DIRECTION($,(1,0,0));
+#96=AXIS2_PLACEMENT_3D($,#93,#94,#95);
+#97=CIRCLE($,#96,12);
+#98=EDGE_CURVE($,#92,#92,#97,.T.);
+#99=ORIENTED_EDGE($,$,$,#98,.T.);
+#100=EDGE_LOOP($,(#99));
+#101=FACE_BOUND('',#100,.T.);
+#102=ADVANCED_FACE('',(#90,#101),#56,.T.);
+#103=CARTESIAN_POINT($,(0,-30,0));
+#104=DIRECTION($,(0,-1,0));
+#105=DIRECTION($,(1,0,0));
+#106=AXIS2_PLACEMENT_3D($,#103,#104,#105);
+#107=PLANE($,#106);
+#108=ORIENTED_EDGE($,$,$,#14,.T.);
+#109=CARTESIAN_POINT($,(50,-30,-0));
+#110=DIRECTION($,(0,0,1));
+#111=VECTOR($,#110,1);
+#112=LINE($,#109,#111);
+#113=EDGE_CURVE($,#9,#60,#112,.T.);
+#114=ORIENTED_EDGE($,$,$,#113,.T.);
+#115=ORIENTED_EDGE($,$,$,#65,.F.);
+#116=CARTESIAN_POINT($,(-50,-30,-0));
+#117=DIRECTION($,(0,0,1));
+#118=VECTOR($,#117,1);
+#119=LINE($,#116,#118);
+#120=EDGE_CURVE($,#7,#58,#119,.T.);
+#121=ORIENTED_EDGE($,$,$,#120,.F.);
+#122=EDGE_LOOP($,(#108,#114,#115,#121));
+#123=FACE_OUTER_BOUND('',#122,.T.);
+#124=ADVANCED_FACE('',(#123),#107,.T.);
+#125=CARTESIAN_POINT($,(50,0,0));
+#126=DIRECTION($,(1,0,0));
+#127=DIRECTION($,(0,1,0));
+#128=AXIS2_PLACEMENT_3D($,#125,#126,#127);
+#129=PLANE($,#128);
+#130=ORIENTED_EDGE($,$,$,#22,.T.);
+#131=CARTESIAN_POINT($,(50,30,-0));
+#132=DIRECTION($,(0,0,1));
+#133=VECTOR($,#132,1);
+#134=LINE($,#131,#133);
+#135=EDGE_CURVE($,#17,#68,#134,.T.);
+#136=ORIENTED_EDGE($,$,$,#135,.T.);
+#137=ORIENTED_EDGE($,$,$,#73,.F.);
+#138=ORIENTED_EDGE($,$,$,#113,.F.);
+#139=EDGE_LOOP($,(#130,#136,#137,#138));
+#140=FACE_OUTER_BOUND('',#139,.T.);
+#141=ADVANCED_FACE('',(#140),#129,.T.);
+#142=CARTESIAN_POINT($,(0,30,0));
+#143=DIRECTION($,(0,1,0));
+#144=DIRECTION($,(-1,0,0));
+#145=AXIS2_PLACEMENT_3D($,#142,#143,#144);
+#146=PLANE($,#145);
+#147=ORIENTED_EDGE($,$,$,#30,.T.);
+#148=CARTESIAN_POINT($,(-50,30,-0));
+#149=DIRECTION($,(0,0,1));
+#150=VECTOR($,#149,1);
+#151=LINE($,#148,#150);
+#152=EDGE_CURVE($,#25,#76,#151,.T.);
+#153=ORIENTED_EDGE($,$,$,#152,.T.);
+#154=ORIENTED_EDGE($,$,$,#81,.F.);
+#155=ORIENTED_EDGE($,$,$,#135,.F.);
+#156=EDGE_LOOP($,(#147,#153,#154,#155));
+#157=FACE_OUTER_BOUND('',#156,.T.);
+#158=ADVANCED_FACE('',(#157),#146,.T.);
+#159=CARTESIAN_POINT($,(-50,0,0));
+#160=DIRECTION($,(-1,0,0));
+#161=DIRECTION($,(0,1,0));
+#162=AXIS2_PLACEMENT_3D($,#159,#160,#161);
+#163=PLANE($,#162);
+#164=ORIENTED_EDGE($,$,$,#36,.T.);
+#165=ORIENTED_EDGE($,$,$,#120,.T.);
+#166=ORIENTED_EDGE($,$,$,#87,.F.);
+#167=ORIENTED_EDGE($,$,$,#152,.F.);
+#168=EDGE_LOOP($,(#164,#165,#166,#167));
+#169=FACE_OUTER_BOUND('',#168,.T.);
+#170=ADVANCED_FACE('',(#169),#163,.T.);
+#171=CARTESIAN_POINT($,(0,0,0));
+#172=DIRECTION($,(0,0,1));
+#173=DIRECTION($,(1,0,0));
+#174=AXIS2_PLACEMENT_3D($,#171,#172,#173);
+#175=CYLINDRICAL_SURFACE($,#174,12);
+#176=CARTESIAN_POINT($,(12,0,16));
+#177=VERTEX_POINT($,#176);
+#178=CARTESIAN_POINT($,(12,0,0));
+#179=VERTEX_POINT($,#178);
+#180=CARTESIAN_POINT($,(12,0,16));
+#181=DIRECTION($,(0,0,-1));
+#182=VECTOR($,#181,1);
+#183=LINE($,#180,#182);
+#184=EDGE_CURVE($,#177,#179,#183,.T.);
+#185=ORIENTED_EDGE($,$,$,#184,.T.);
+#186=ORIENTED_EDGE($,$,$,#47,.T.);
+#187=ORIENTED_EDGE($,$,$,#184,.F.);
+#188=ORIENTED_EDGE($,$,$,#98,.F.);
+#189=EDGE_LOOP($,(#185,#186,#187,#188));
+#190=FACE_OUTER_BOUND('',#189,.T.);
+#191=ADVANCED_FACE('',(#190),#175,.T.);
+#192=CLOSED_SHELL($,(#51,#102,#124,#141,#158,#170,#191));
+#193=MANIFOLD_SOLID_BREP('AetherisBody',#192);
+#194=APPLICATION_CONTEXT('mechanical design');
+#195=PRODUCT_CONTEXT('',#194,'mechanical');
+#196=PRODUCT('AETHERIS','AetherisBody','',(#195));
+#197=PRODUCT_DEFINITION_FORMATION('','',#196);
+#198=PRODUCT_DEFINITION_CONTEXT('design',#194,'design');
+#199=PRODUCT_DEFINITION('','',#197,#198);
+#200=PRODUCT_DEFINITION_SHAPE('','',#199);
+#201=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));
+#202=(NAMED_UNIT(*)PLANE_ANGLE_UNIT()SI_UNIT($,.RADIAN.));
+#203=(NAMED_UNIT(*)SI_UNIT($,.STERADIAN.)SOLID_ANGLE_UNIT());
+#204=(GEOMETRIC_REPRESENTATION_CONTEXT(3)GLOBAL_UNIT_ASSIGNED_CONTEXT((#201,#202,#203))REPRESENTATION_CONTEXT('3','3D'));
+#205=SHAPE_REPRESENTATION('AetherisBody',(#193),#204);
+#206=SHAPE_DEFINITION_REPRESENTATION(#200,#205);
+ENDSEC;
+END-ISO-10303-21;
diff --git a/docs/forge/artifacts/host-m2/run/batch-b/AB-305/AB-305.step b/docs/forge/artifacts/host-m2/run/batch-b/AB-305/AB-305.step
new file mode 100644
index 00000000..f77d66c1
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/batch-b/AB-305/AB-305.step
@@ -0,0 +1,215 @@
+ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('Aetheris AP242 subset export'),'2;1');
+FILE_NAME('aetheris_export.step','1970-01-01T00:00:00',('Aetheris'),('Aetheris'),'Aetheris.Kernel','Aetheris.Kernel','');
+FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));
+ENDSEC;
+DATA;
+#1=CARTESIAN_POINT($,(0,0,0));
+#2=DIRECTION($,(0,0,-1));
+#3=DIRECTION($,(1,0,0));
+#4=AXIS2_PLACEMENT_3D($,#1,#2,#3);
+#5=PLANE($,#4);
+#6=CARTESIAN_POINT($,(-60,-35,-0));
+#7=VERTEX_POINT($,#6);
+#8=CARTESIAN_POINT($,(60,-35,-0));
+#9=VERTEX_POINT($,#8);
+#10=CARTESIAN_POINT($,(-60,-35,-0));
+#11=DIRECTION($,(1,0,0));
+#12=VECTOR($,#11,1);
+#13=LINE($,#10,#12);
+#14=EDGE_CURVE($,#7,#9,#13,.T.);
+#15=ORIENTED_EDGE($,$,$,#14,.T.);
+#16=CARTESIAN_POINT($,(60,35,-0));
+#17=VERTEX_POINT($,#16);
+#18=CARTESIAN_POINT($,(60,-35,-0));
+#19=DIRECTION($,(0,1,0));
+#20=VECTOR($,#19,1);
+#21=LINE($,#18,#20);
+#22=EDGE_CURVE($,#9,#17,#21,.T.);
+#23=ORIENTED_EDGE($,$,$,#22,.T.);
+#24=CARTESIAN_POINT($,(-60,35,-0));
+#25=VERTEX_POINT($,#24);
+#26=CARTESIAN_POINT($,(60,35,-0));
+#27=DIRECTION($,(-1,0,0));
+#28=VECTOR($,#27,1);
+#29=LINE($,#26,#28);
+#30=EDGE_CURVE($,#17,#25,#29,.T.);
+#31=ORIENTED_EDGE($,$,$,#30,.T.);
+#32=CARTESIAN_POINT($,(-60,35,-0));
+#33=DIRECTION($,(0,-1,0));
+#34=VECTOR($,#33,1);
+#35=LINE($,#32,#34);
+#36=EDGE_CURVE($,#25,#7,#35,.T.);
+#37=ORIENTED_EDGE($,$,$,#36,.T.);
+#38=EDGE_LOOP($,(#15,#23,#31,#37));
+#39=FACE_OUTER_BOUND('',#38,.T.);
+#40=CARTESIAN_POINT($,(15,0,0));
+#41=VERTEX_POINT($,#40);
+#42=CARTESIAN_POINT($,(0,0,0));
+#43=DIRECTION($,(0,0,1));
+#44=DIRECTION($,(1,0,0));
+#45=AXIS2_PLACEMENT_3D($,#42,#43,#44);
+#46=CIRCLE($,#45,15);
+#47=EDGE_CURVE($,#41,#41,#46,.T.);
+#48=ORIENTED_EDGE($,$,$,#47,.F.);
+#49=EDGE_LOOP($,(#48));
+#50=FACE_BOUND('',#49,.T.);
+#51=ADVANCED_FACE('',(#39,#50),#5,.T.);
+#52=CARTESIAN_POINT($,(0,0,20));
+#53=DIRECTION($,(0,0,1));
+#54=DIRECTION($,(1,0,0));
+#55=AXIS2_PLACEMENT_3D($,#52,#53,#54);
+#56=PLANE($,#55);
+#57=CARTESIAN_POINT($,(-60,-35,20));
+#58=VERTEX_POINT($,#57);
+#59=CARTESIAN_POINT($,(60,-35,20));
+#60=VERTEX_POINT($,#59);
+#61=CARTESIAN_POINT($,(-60,-35,20));
+#62=DIRECTION($,(1,0,0));
+#63=VECTOR($,#62,1);
+#64=LINE($,#61,#63);
+#65=EDGE_CURVE($,#58,#60,#64,.T.);
+#66=ORIENTED_EDGE($,$,$,#65,.T.);
+#67=CARTESIAN_POINT($,(60,35,20));
+#68=VERTEX_POINT($,#67);
+#69=CARTESIAN_POINT($,(60,-35,20));
+#70=DIRECTION($,(0,1,0));
+#71=VECTOR($,#70,1);
+#72=LINE($,#69,#71);
+#73=EDGE_CURVE($,#60,#68,#72,.T.);
+#74=ORIENTED_EDGE($,$,$,#73,.T.);
+#75=CARTESIAN_POINT($,(-60,35,20));
+#76=VERTEX_POINT($,#75);
+#77=CARTESIAN_POINT($,(60,35,20));
+#78=DIRECTION($,(-1,0,0));
+#79=VECTOR($,#78,1);
+#80=LINE($,#77,#79);
+#81=EDGE_CURVE($,#68,#76,#80,.T.);
+#82=ORIENTED_EDGE($,$,$,#81,.T.);
+#83=CARTESIAN_POINT($,(-60,35,20));
+#84=DIRECTION($,(0,-1,0));
+#85=VECTOR($,#84,1);
+#86=LINE($,#83,#85);
+#87=EDGE_CURVE($,#76,#58,#86,.T.);
+#88=ORIENTED_EDGE($,$,$,#87,.T.);
+#89=EDGE_LOOP($,(#66,#74,#82,#88));
+#90=FACE_OUTER_BOUND('',#89,.T.);
+#91=CARTESIAN_POINT($,(15,0,20));
+#92=VERTEX_POINT($,#91);
+#93=CARTESIAN_POINT($,(0,0,20));
+#94=DIRECTION($,(0,0,1));
+#95=DIRECTION($,(1,0,0));
+#96=AXIS2_PLACEMENT_3D($,#93,#94,#95);
+#97=CIRCLE($,#96,15);
+#98=EDGE_CURVE($,#92,#92,#97,.T.);
+#99=ORIENTED_EDGE($,$,$,#98,.T.);
+#100=EDGE_LOOP($,(#99));
+#101=FACE_BOUND('',#100,.T.);
+#102=ADVANCED_FACE('',(#90,#101),#56,.T.);
+#103=CARTESIAN_POINT($,(0,-35,0));
+#104=DIRECTION($,(0,-1,0));
+#105=DIRECTION($,(1,0,0));
+#106=AXIS2_PLACEMENT_3D($,#103,#104,#105);
+#107=PLANE($,#106);
+#108=ORIENTED_EDGE($,$,$,#14,.T.);
+#109=CARTESIAN_POINT($,(60,-35,-0));
+#110=DIRECTION($,(0,0,1));
+#111=VECTOR($,#110,1);
+#112=LINE($,#109,#111);
+#113=EDGE_CURVE($,#9,#60,#112,.T.);
+#114=ORIENTED_EDGE($,$,$,#113,.T.);
+#115=ORIENTED_EDGE($,$,$,#65,.F.);
+#116=CARTESIAN_POINT($,(-60,-35,-0));
+#117=DIRECTION($,(0,0,1));
+#118=VECTOR($,#117,1);
+#119=LINE($,#116,#118);
+#120=EDGE_CURVE($,#7,#58,#119,.T.);
+#121=ORIENTED_EDGE($,$,$,#120,.F.);
+#122=EDGE_LOOP($,(#108,#114,#115,#121));
+#123=FACE_OUTER_BOUND('',#122,.T.);
+#124=ADVANCED_FACE('',(#123),#107,.T.);
+#125=CARTESIAN_POINT($,(60,0,0));
+#126=DIRECTION($,(1,0,0));
+#127=DIRECTION($,(0,1,0));
+#128=AXIS2_PLACEMENT_3D($,#125,#126,#127);
+#129=PLANE($,#128);
+#130=ORIENTED_EDGE($,$,$,#22,.T.);
+#131=CARTESIAN_POINT($,(60,35,-0));
+#132=DIRECTION($,(0,0,1));
+#133=VECTOR($,#132,1);
+#134=LINE($,#131,#133);
+#135=EDGE_CURVE($,#17,#68,#134,.T.);
+#136=ORIENTED_EDGE($,$,$,#135,.T.);
+#137=ORIENTED_EDGE($,$,$,#73,.F.);
+#138=ORIENTED_EDGE($,$,$,#113,.F.);
+#139=EDGE_LOOP($,(#130,#136,#137,#138));
+#140=FACE_OUTER_BOUND('',#139,.T.);
+#141=ADVANCED_FACE('',(#140),#129,.T.);
+#142=CARTESIAN_POINT($,(0,35,0));
+#143=DIRECTION($,(0,1,0));
+#144=DIRECTION($,(-1,0,0));
+#145=AXIS2_PLACEMENT_3D($,#142,#143,#144);
+#146=PLANE($,#145);
+#147=ORIENTED_EDGE($,$,$,#30,.T.);
+#148=CARTESIAN_POINT($,(-60,35,-0));
+#149=DIRECTION($,(0,0,1));
+#150=VECTOR($,#149,1);
+#151=LINE($,#148,#150);
+#152=EDGE_CURVE($,#25,#76,#151,.T.);
+#153=ORIENTED_EDGE($,$,$,#152,.T.);
+#154=ORIENTED_EDGE($,$,$,#81,.F.);
+#155=ORIENTED_EDGE($,$,$,#135,.F.);
+#156=EDGE_LOOP($,(#147,#153,#154,#155));
+#157=FACE_OUTER_BOUND('',#156,.T.);
+#158=ADVANCED_FACE('',(#157),#146,.T.);
+#159=CARTESIAN_POINT($,(-60,0,0));
+#160=DIRECTION($,(-1,0,0));
+#161=DIRECTION($,(0,1,0));
+#162=AXIS2_PLACEMENT_3D($,#159,#160,#161);
+#163=PLANE($,#162);
+#164=ORIENTED_EDGE($,$,$,#36,.T.);
+#165=ORIENTED_EDGE($,$,$,#120,.T.);
+#166=ORIENTED_EDGE($,$,$,#87,.F.);
+#167=ORIENTED_EDGE($,$,$,#152,.F.);
+#168=EDGE_LOOP($,(#164,#165,#166,#167));
+#169=FACE_OUTER_BOUND('',#168,.T.);
+#170=ADVANCED_FACE('',(#169),#163,.T.);
+#171=CARTESIAN_POINT($,(0,0,0));
+#172=DIRECTION($,(0,0,1));
+#173=DIRECTION($,(1,0,0));
+#174=AXIS2_PLACEMENT_3D($,#171,#172,#173);
+#175=CYLINDRICAL_SURFACE($,#174,15);
+#176=CARTESIAN_POINT($,(15,0,20));
+#177=VERTEX_POINT($,#176);
+#178=CARTESIAN_POINT($,(15,0,0));
+#179=VERTEX_POINT($,#178);
+#180=CARTESIAN_POINT($,(15,0,20));
+#181=DIRECTION($,(0,0,-1));
+#182=VECTOR($,#181,1);
+#183=LINE($,#180,#182);
+#184=EDGE_CURVE($,#177,#179,#183,.T.);
+#185=ORIENTED_EDGE($,$,$,#184,.T.);
+#186=ORIENTED_EDGE($,$,$,#47,.T.);
+#187=ORIENTED_EDGE($,$,$,#184,.F.);
+#188=ORIENTED_EDGE($,$,$,#98,.F.);
+#189=EDGE_LOOP($,(#185,#186,#187,#188));
+#190=FACE_OUTER_BOUND('',#189,.T.);
+#191=ADVANCED_FACE('',(#190),#175,.T.);
+#192=CLOSED_SHELL($,(#51,#102,#124,#141,#158,#170,#191));
+#193=MANIFOLD_SOLID_BREP('AetherisBody',#192);
+#194=APPLICATION_CONTEXT('mechanical design');
+#195=PRODUCT_CONTEXT('',#194,'mechanical');
+#196=PRODUCT('AETHERIS','AetherisBody','',(#195));
+#197=PRODUCT_DEFINITION_FORMATION('','',#196);
+#198=PRODUCT_DEFINITION_CONTEXT('design',#194,'design');
+#199=PRODUCT_DEFINITION('','',#197,#198);
+#200=PRODUCT_DEFINITION_SHAPE('','',#199);
+#201=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));
+#202=(NAMED_UNIT(*)PLANE_ANGLE_UNIT()SI_UNIT($,.RADIAN.));
+#203=(NAMED_UNIT(*)SI_UNIT($,.STERADIAN.)SOLID_ANGLE_UNIT());
+#204=(GEOMETRIC_REPRESENTATION_CONTEXT(3)GLOBAL_UNIT_ASSIGNED_CONTEXT((#201,#202,#203))REPRESENTATION_CONTEXT('3','3D'));
+#205=SHAPE_REPRESENTATION('AetherisBody',(#193),#204);
+#206=SHAPE_DEFINITION_REPRESENTATION(#200,#205);
+ENDSEC;
+END-ISO-10303-21;
diff --git a/docs/forge/artifacts/host-m2/run/batch-b/manifest.json b/docs/forge/artifacts/host-m2/run/batch-b/manifest.json
new file mode 100644
index 00000000..5104e362
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/batch-b/manifest.json
@@ -0,0 +1,20 @@
+[
+ {
+ "PartNumber": "AB-204",
+ "TemplateSpecialization": "template:1d2e995f2be2e479",
+ "StepPath": "C:\\Users\\yuech\\source\\repos\\Aetheris\\docs\\forge\\artifacts\\host-m2\\run\\batch-b\\AB-204\\AB-204.step",
+ "StepSha256": "3ACD9BEA0CE21C5FDF7699A27128D8B11F05F4719C939746742AE1FC7C3F7259",
+ "Diagnostics": [],
+ "MappingMilliseconds": 4.3329,
+ "CompilationMilliseconds": 245.4429
+ },
+ {
+ "PartNumber": "AB-305",
+ "TemplateSpecialization": "template:eea80ba75fd5599f",
+ "StepPath": "C:\\Users\\yuech\\source\\repos\\Aetheris\\docs\\forge\\artifacts\\host-m2\\run\\batch-b\\AB-305\\AB-305.step",
+ "StepSha256": "5764A7273643806522A13864BAF28C331D10B40C6E82FE513FB7FDEBB90BD4AF",
+ "Diagnostics": [],
+ "MappingMilliseconds": 0.0177,
+ "CompilationMilliseconds": 5.2148
+ }
+]
\ No newline at end of file
diff --git a/docs/forge/artifacts/host-m2/run/generate-batch-a.txt b/docs/forge/artifacts/host-m2/run/generate-batch-a.txt
new file mode 100644
index 00000000..d549f198
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/generate-batch-a.txt
@@ -0,0 +1,9 @@
+AB-204: template:1d2e995f2be2e479
+ STEP C:\Users\yuech\source\repos\Aetheris\docs\forge\artifacts\host-m2\run\batch-a\AB-204\AB-204.step
+ SHA256 3ACD9BEA0CE21C5FDF7699A27128D8B11F05F4719C939746742AE1FC7C3F7259
+ mapping 4.55 ms; compile+STEP 252.38 ms
+AB-305: template:eea80ba75fd5599f
+ STEP C:\Users\yuech\source\repos\Aetheris\docs\forge\artifacts\host-m2\run\batch-a\AB-305\AB-305.step
+ SHA256 5764A7273643806522A13864BAF28C331D10B40C6E82FE513FB7FDEBB90BD4AF
+ mapping 0.02 ms; compile+STEP 5.06 ms
+SQLite/LINQ: 249.97 ms; generated: 2
diff --git a/docs/forge/artifacts/host-m2/run/generate-batch-b.txt b/docs/forge/artifacts/host-m2/run/generate-batch-b.txt
new file mode 100644
index 00000000..77eaa079
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/generate-batch-b.txt
@@ -0,0 +1,9 @@
+AB-204: template:1d2e995f2be2e479
+ STEP C:\Users\yuech\source\repos\Aetheris\docs\forge\artifacts\host-m2\run\batch-b\AB-204\AB-204.step
+ SHA256 3ACD9BEA0CE21C5FDF7699A27128D8B11F05F4719C939746742AE1FC7C3F7259
+ mapping 4.33 ms; compile+STEP 245.44 ms
+AB-305: template:eea80ba75fd5599f
+ STEP C:\Users\yuech\source\repos\Aetheris\docs\forge\artifacts\host-m2\run\batch-b\AB-305\AB-305.step
+ SHA256 5764A7273643806522A13864BAF28C331D10B40C6E82FE513FB7FDEBB90BD4AF
+ mapping 0.02 ms; compile+STEP 5.21 ms
+SQLite/LINQ: 230.60 ms; generated: 2
diff --git a/docs/forge/artifacts/host-m2/run/generate-single.txt b/docs/forge/artifacts/host-m2/run/generate-single.txt
new file mode 100644
index 00000000..3f9eb7a4
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/generate-single.txt
@@ -0,0 +1,5 @@
+AB-204: template:1d2e995f2be2e479
+ STEP C:\Users\yuech\source\repos\Aetheris\docs\forge\artifacts\host-m2\run\single\AB-204\AB-204.step
+ SHA256 3ACD9BEA0CE21C5FDF7699A27128D8B11F05F4719C939746742AE1FC7C3F7259
+ mapping 4.38 ms; compile+STEP 230.06 ms
+SQLite/LINQ: 228.24 ms; generated: 1
diff --git a/docs/forge/artifacts/host-m2/run/inspect-ab-204.json b/docs/forge/artifacts/host-m2/run/inspect-ab-204.json
new file mode 100644
index 00000000..3461fead
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/inspect-ab-204.json
@@ -0,0 +1,67 @@
+{
+ "stepPath": "C:\\Users\\yuech\\source\\repos\\Aetheris\\docs\\forge\\artifacts\\host-m2\\run\\single\\AB-204\\AB-204.step",
+ "summary": {
+ "bodyCount": 1,
+ "shellCount": 1,
+ "faceCount": 7,
+ "edgeCount": 15,
+ "vertexCount": 12,
+ "boundingBox": {
+ "min": {
+ "x": -50,
+ "y": -30,
+ "z": -0
+ },
+ "max": {
+ "x": 50,
+ "y": 30,
+ "z": 16
+ }
+ },
+ "structuralAssessment": "enclosed-manifold",
+ "surfaceFamilies": {
+ "plane": 6,
+ "cylinder": 1,
+ "cone": 0,
+ "sphere": 0,
+ "torus": 0,
+ "bspline": 0,
+ "linear-extrusion": 0,
+ "surface-of-revolution": 0,
+ "other": 0
+ },
+ "curveFamilies": {
+ "line": 13,
+ "circle": 2,
+ "hyperbola": 0,
+ "ellipse": 0,
+ "bspline": 0,
+ "unsupported": 0
+ },
+ "structuralAssessmentBasis": "derived from ordered directed coedge traversal plus imported topology edge-to-face coedge incidence counts",
+ "lengthUnit": "mm",
+ "lengthUnitBasis": "assumed; STEP import length units not yet preserved",
+ "faceIds": {
+ "min": 1,
+ "max": 7,
+ "count": 7,
+ "contiguous": true
+ },
+ "edgeIds": {
+ "min": 1,
+ "max": 15,
+ "count": 15,
+ "contiguous": true
+ },
+ "vertexIds": {
+ "min": 1,
+ "max": 12,
+ "count": 12,
+ "contiguous": true
+ }
+ },
+ "face": null,
+ "edge": null,
+ "vertex": null,
+ "notes": []
+}
diff --git a/docs/forge/artifacts/host-m2/run/list.txt b/docs/forge/artifacts/host-m2/run/list.txt
new file mode 100644
index 00000000..4a85bf37
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/list.txt
@@ -0,0 +1,6 @@
+PartNumber Width Height Depth Bore Material Revision
+AB-101 80 50 12 18 6061-T6 1.0.0
+SB-210 100 60 18 22 4140 2.0.0
+AB-204 100 60 16 24 6061-T6 2.1.0
+AB-305 120 70 20 30 6061-T6 3.0.1
+SQLite/LINQ: 213.19 ms; rows: 4
diff --git a/docs/forge/artifacts/host-m2/run/products.sqlite b/docs/forge/artifacts/host-m2/run/products.sqlite
new file mode 100644
index 00000000..a3151034
Binary files /dev/null and b/docs/forge/artifacts/host-m2/run/products.sqlite differ
diff --git a/docs/forge/artifacts/host-m2/run/query.txt b/docs/forge/artifacts/host-m2/run/query.txt
new file mode 100644
index 00000000..dadc148f
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/query.txt
@@ -0,0 +1,4 @@
+PartNumber Width Height Depth Bore Material Revision
+AB-204 100 60 16 24 6061-T6 2.1.0
+AB-305 120 70 20 30 6061-T6 3.0.1
+SQLite/LINQ: 225.53 ms; rows: 2
diff --git a/docs/forge/artifacts/host-m2/run/seed.txt b/docs/forge/artifacts/host-m2/run/seed.txt
new file mode 100644
index 00000000..285d8343
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/seed.txt
@@ -0,0 +1 @@
+Seeded 4 configurations in C:\Users\yuech\source\repos\Aetheris\docs\forge\artifacts\host-m2\run\products.sqlite
diff --git a/docs/forge/artifacts/host-m2/run/single/AB-204/AB-204.step b/docs/forge/artifacts/host-m2/run/single/AB-204/AB-204.step
new file mode 100644
index 00000000..10fe4dae
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/single/AB-204/AB-204.step
@@ -0,0 +1,215 @@
+ISO-10303-21;
+HEADER;
+FILE_DESCRIPTION(('Aetheris AP242 subset export'),'2;1');
+FILE_NAME('aetheris_export.step','1970-01-01T00:00:00',('Aetheris'),('Aetheris'),'Aetheris.Kernel','Aetheris.Kernel','');
+FILE_SCHEMA(('AP242_MANAGED_MODEL_BASED_3D_ENGINEERING_MIM_LF'));
+ENDSEC;
+DATA;
+#1=CARTESIAN_POINT($,(0,0,0));
+#2=DIRECTION($,(0,0,-1));
+#3=DIRECTION($,(1,0,0));
+#4=AXIS2_PLACEMENT_3D($,#1,#2,#3);
+#5=PLANE($,#4);
+#6=CARTESIAN_POINT($,(-50,-30,-0));
+#7=VERTEX_POINT($,#6);
+#8=CARTESIAN_POINT($,(50,-30,-0));
+#9=VERTEX_POINT($,#8);
+#10=CARTESIAN_POINT($,(-50,-30,-0));
+#11=DIRECTION($,(1,0,0));
+#12=VECTOR($,#11,1);
+#13=LINE($,#10,#12);
+#14=EDGE_CURVE($,#7,#9,#13,.T.);
+#15=ORIENTED_EDGE($,$,$,#14,.T.);
+#16=CARTESIAN_POINT($,(50,30,-0));
+#17=VERTEX_POINT($,#16);
+#18=CARTESIAN_POINT($,(50,-30,-0));
+#19=DIRECTION($,(0,1,0));
+#20=VECTOR($,#19,1);
+#21=LINE($,#18,#20);
+#22=EDGE_CURVE($,#9,#17,#21,.T.);
+#23=ORIENTED_EDGE($,$,$,#22,.T.);
+#24=CARTESIAN_POINT($,(-50,30,-0));
+#25=VERTEX_POINT($,#24);
+#26=CARTESIAN_POINT($,(50,30,-0));
+#27=DIRECTION($,(-1,0,0));
+#28=VECTOR($,#27,1);
+#29=LINE($,#26,#28);
+#30=EDGE_CURVE($,#17,#25,#29,.T.);
+#31=ORIENTED_EDGE($,$,$,#30,.T.);
+#32=CARTESIAN_POINT($,(-50,30,-0));
+#33=DIRECTION($,(0,-1,0));
+#34=VECTOR($,#33,1);
+#35=LINE($,#32,#34);
+#36=EDGE_CURVE($,#25,#7,#35,.T.);
+#37=ORIENTED_EDGE($,$,$,#36,.T.);
+#38=EDGE_LOOP($,(#15,#23,#31,#37));
+#39=FACE_OUTER_BOUND('',#38,.T.);
+#40=CARTESIAN_POINT($,(12,0,0));
+#41=VERTEX_POINT($,#40);
+#42=CARTESIAN_POINT($,(0,0,0));
+#43=DIRECTION($,(0,0,1));
+#44=DIRECTION($,(1,0,0));
+#45=AXIS2_PLACEMENT_3D($,#42,#43,#44);
+#46=CIRCLE($,#45,12);
+#47=EDGE_CURVE($,#41,#41,#46,.T.);
+#48=ORIENTED_EDGE($,$,$,#47,.F.);
+#49=EDGE_LOOP($,(#48));
+#50=FACE_BOUND('',#49,.T.);
+#51=ADVANCED_FACE('',(#39,#50),#5,.T.);
+#52=CARTESIAN_POINT($,(0,0,16));
+#53=DIRECTION($,(0,0,1));
+#54=DIRECTION($,(1,0,0));
+#55=AXIS2_PLACEMENT_3D($,#52,#53,#54);
+#56=PLANE($,#55);
+#57=CARTESIAN_POINT($,(-50,-30,16));
+#58=VERTEX_POINT($,#57);
+#59=CARTESIAN_POINT($,(50,-30,16));
+#60=VERTEX_POINT($,#59);
+#61=CARTESIAN_POINT($,(-50,-30,16));
+#62=DIRECTION($,(1,0,0));
+#63=VECTOR($,#62,1);
+#64=LINE($,#61,#63);
+#65=EDGE_CURVE($,#58,#60,#64,.T.);
+#66=ORIENTED_EDGE($,$,$,#65,.T.);
+#67=CARTESIAN_POINT($,(50,30,16));
+#68=VERTEX_POINT($,#67);
+#69=CARTESIAN_POINT($,(50,-30,16));
+#70=DIRECTION($,(0,1,0));
+#71=VECTOR($,#70,1);
+#72=LINE($,#69,#71);
+#73=EDGE_CURVE($,#60,#68,#72,.T.);
+#74=ORIENTED_EDGE($,$,$,#73,.T.);
+#75=CARTESIAN_POINT($,(-50,30,16));
+#76=VERTEX_POINT($,#75);
+#77=CARTESIAN_POINT($,(50,30,16));
+#78=DIRECTION($,(-1,0,0));
+#79=VECTOR($,#78,1);
+#80=LINE($,#77,#79);
+#81=EDGE_CURVE($,#68,#76,#80,.T.);
+#82=ORIENTED_EDGE($,$,$,#81,.T.);
+#83=CARTESIAN_POINT($,(-50,30,16));
+#84=DIRECTION($,(0,-1,0));
+#85=VECTOR($,#84,1);
+#86=LINE($,#83,#85);
+#87=EDGE_CURVE($,#76,#58,#86,.T.);
+#88=ORIENTED_EDGE($,$,$,#87,.T.);
+#89=EDGE_LOOP($,(#66,#74,#82,#88));
+#90=FACE_OUTER_BOUND('',#89,.T.);
+#91=CARTESIAN_POINT($,(12,0,16));
+#92=VERTEX_POINT($,#91);
+#93=CARTESIAN_POINT($,(0,0,16));
+#94=DIRECTION($,(0,0,1));
+#95=DIRECTION($,(1,0,0));
+#96=AXIS2_PLACEMENT_3D($,#93,#94,#95);
+#97=CIRCLE($,#96,12);
+#98=EDGE_CURVE($,#92,#92,#97,.T.);
+#99=ORIENTED_EDGE($,$,$,#98,.T.);
+#100=EDGE_LOOP($,(#99));
+#101=FACE_BOUND('',#100,.T.);
+#102=ADVANCED_FACE('',(#90,#101),#56,.T.);
+#103=CARTESIAN_POINT($,(0,-30,0));
+#104=DIRECTION($,(0,-1,0));
+#105=DIRECTION($,(1,0,0));
+#106=AXIS2_PLACEMENT_3D($,#103,#104,#105);
+#107=PLANE($,#106);
+#108=ORIENTED_EDGE($,$,$,#14,.T.);
+#109=CARTESIAN_POINT($,(50,-30,-0));
+#110=DIRECTION($,(0,0,1));
+#111=VECTOR($,#110,1);
+#112=LINE($,#109,#111);
+#113=EDGE_CURVE($,#9,#60,#112,.T.);
+#114=ORIENTED_EDGE($,$,$,#113,.T.);
+#115=ORIENTED_EDGE($,$,$,#65,.F.);
+#116=CARTESIAN_POINT($,(-50,-30,-0));
+#117=DIRECTION($,(0,0,1));
+#118=VECTOR($,#117,1);
+#119=LINE($,#116,#118);
+#120=EDGE_CURVE($,#7,#58,#119,.T.);
+#121=ORIENTED_EDGE($,$,$,#120,.F.);
+#122=EDGE_LOOP($,(#108,#114,#115,#121));
+#123=FACE_OUTER_BOUND('',#122,.T.);
+#124=ADVANCED_FACE('',(#123),#107,.T.);
+#125=CARTESIAN_POINT($,(50,0,0));
+#126=DIRECTION($,(1,0,0));
+#127=DIRECTION($,(0,1,0));
+#128=AXIS2_PLACEMENT_3D($,#125,#126,#127);
+#129=PLANE($,#128);
+#130=ORIENTED_EDGE($,$,$,#22,.T.);
+#131=CARTESIAN_POINT($,(50,30,-0));
+#132=DIRECTION($,(0,0,1));
+#133=VECTOR($,#132,1);
+#134=LINE($,#131,#133);
+#135=EDGE_CURVE($,#17,#68,#134,.T.);
+#136=ORIENTED_EDGE($,$,$,#135,.T.);
+#137=ORIENTED_EDGE($,$,$,#73,.F.);
+#138=ORIENTED_EDGE($,$,$,#113,.F.);
+#139=EDGE_LOOP($,(#130,#136,#137,#138));
+#140=FACE_OUTER_BOUND('',#139,.T.);
+#141=ADVANCED_FACE('',(#140),#129,.T.);
+#142=CARTESIAN_POINT($,(0,30,0));
+#143=DIRECTION($,(0,1,0));
+#144=DIRECTION($,(-1,0,0));
+#145=AXIS2_PLACEMENT_3D($,#142,#143,#144);
+#146=PLANE($,#145);
+#147=ORIENTED_EDGE($,$,$,#30,.T.);
+#148=CARTESIAN_POINT($,(-50,30,-0));
+#149=DIRECTION($,(0,0,1));
+#150=VECTOR($,#149,1);
+#151=LINE($,#148,#150);
+#152=EDGE_CURVE($,#25,#76,#151,.T.);
+#153=ORIENTED_EDGE($,$,$,#152,.T.);
+#154=ORIENTED_EDGE($,$,$,#81,.F.);
+#155=ORIENTED_EDGE($,$,$,#135,.F.);
+#156=EDGE_LOOP($,(#147,#153,#154,#155));
+#157=FACE_OUTER_BOUND('',#156,.T.);
+#158=ADVANCED_FACE('',(#157),#146,.T.);
+#159=CARTESIAN_POINT($,(-50,0,0));
+#160=DIRECTION($,(-1,0,0));
+#161=DIRECTION($,(0,1,0));
+#162=AXIS2_PLACEMENT_3D($,#159,#160,#161);
+#163=PLANE($,#162);
+#164=ORIENTED_EDGE($,$,$,#36,.T.);
+#165=ORIENTED_EDGE($,$,$,#120,.T.);
+#166=ORIENTED_EDGE($,$,$,#87,.F.);
+#167=ORIENTED_EDGE($,$,$,#152,.F.);
+#168=EDGE_LOOP($,(#164,#165,#166,#167));
+#169=FACE_OUTER_BOUND('',#168,.T.);
+#170=ADVANCED_FACE('',(#169),#163,.T.);
+#171=CARTESIAN_POINT($,(0,0,0));
+#172=DIRECTION($,(0,0,1));
+#173=DIRECTION($,(1,0,0));
+#174=AXIS2_PLACEMENT_3D($,#171,#172,#173);
+#175=CYLINDRICAL_SURFACE($,#174,12);
+#176=CARTESIAN_POINT($,(12,0,16));
+#177=VERTEX_POINT($,#176);
+#178=CARTESIAN_POINT($,(12,0,0));
+#179=VERTEX_POINT($,#178);
+#180=CARTESIAN_POINT($,(12,0,16));
+#181=DIRECTION($,(0,0,-1));
+#182=VECTOR($,#181,1);
+#183=LINE($,#180,#182);
+#184=EDGE_CURVE($,#177,#179,#183,.T.);
+#185=ORIENTED_EDGE($,$,$,#184,.T.);
+#186=ORIENTED_EDGE($,$,$,#47,.T.);
+#187=ORIENTED_EDGE($,$,$,#184,.F.);
+#188=ORIENTED_EDGE($,$,$,#98,.F.);
+#189=EDGE_LOOP($,(#185,#186,#187,#188));
+#190=FACE_OUTER_BOUND('',#189,.T.);
+#191=ADVANCED_FACE('',(#190),#175,.T.);
+#192=CLOSED_SHELL($,(#51,#102,#124,#141,#158,#170,#191));
+#193=MANIFOLD_SOLID_BREP('AetherisBody',#192);
+#194=APPLICATION_CONTEXT('mechanical design');
+#195=PRODUCT_CONTEXT('',#194,'mechanical');
+#196=PRODUCT('AETHERIS','AetherisBody','',(#195));
+#197=PRODUCT_DEFINITION_FORMATION('','',#196);
+#198=PRODUCT_DEFINITION_CONTEXT('design',#194,'design');
+#199=PRODUCT_DEFINITION('','',#197,#198);
+#200=PRODUCT_DEFINITION_SHAPE('','',#199);
+#201=(LENGTH_UNIT()NAMED_UNIT(*)SI_UNIT(.MILLI.,.METRE.));
+#202=(NAMED_UNIT(*)PLANE_ANGLE_UNIT()SI_UNIT($,.RADIAN.));
+#203=(NAMED_UNIT(*)SI_UNIT($,.STERADIAN.)SOLID_ANGLE_UNIT());
+#204=(GEOMETRIC_REPRESENTATION_CONTEXT(3)GLOBAL_UNIT_ASSIGNED_CONTEXT((#201,#202,#203))REPRESENTATION_CONTEXT('3','3D'));
+#205=SHAPE_REPRESENTATION('AetherisBody',(#193),#204);
+#206=SHAPE_DEFINITION_REPRESENTATION(#200,#205);
+ENDSEC;
+END-ISO-10303-21;
diff --git a/docs/forge/artifacts/host-m2/run/single/manifest.json b/docs/forge/artifacts/host-m2/run/single/manifest.json
new file mode 100644
index 00000000..ff41cb6d
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/run/single/manifest.json
@@ -0,0 +1,11 @@
+[
+ {
+ "PartNumber": "AB-204",
+ "TemplateSpecialization": "template:1d2e995f2be2e479",
+ "StepPath": "C:\\Users\\yuech\\source\\repos\\Aetheris\\docs\\forge\\artifacts\\host-m2\\run\\single\\AB-204\\AB-204.step",
+ "StepSha256": "3ACD9BEA0CE21C5FDF7699A27128D8B11F05F4719C939746742AE1FC7C3F7259",
+ "Diagnostics": [],
+ "MappingMilliseconds": 4.3754,
+ "CompilationMilliseconds": 230.0563
+ }
+]
\ No newline at end of file
diff --git a/docs/forge/artifacts/host-m2/schema.sql b/docs/forge/artifacts/host-m2/schema.sql
new file mode 100644
index 00000000..f1b64834
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/schema.sql
@@ -0,0 +1,33 @@
+CREATE TABLE Materials (
+ Id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+ Name TEXT NOT NULL,
+ Grade TEXT NOT NULL,
+ IsAluminum INTEGER NOT NULL
+);
+CREATE UNIQUE INDEX IX_Materials_Grade ON Materials (Grade);
+
+CREATE TABLE DrawingMetadata (
+ Id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+ Company TEXT NOT NULL,
+ Author TEXT NOT NULL,
+ Description TEXT NOT NULL
+);
+
+CREATE TABLE BearingBlockConfigurations (
+ Id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
+ PartNumber TEXT NOT NULL,
+ WidthMillimeters REAL NOT NULL,
+ HeightMillimeters REAL NOT NULL,
+ DepthMillimeters REAL NOT NULL,
+ BoreDiameterMillimeters REAL NOT NULL,
+ BoreTolerancePlusMillimeters REAL NOT NULL,
+ BoreToleranceMinusMillimeters REAL NOT NULL,
+ RevisionMajor INTEGER NOT NULL,
+ RevisionMinor INTEGER NOT NULL,
+ RevisionPatch INTEGER NOT NULL,
+ IsProduction INTEGER NOT NULL,
+ IsCurrent INTEGER NOT NULL,
+ MaterialId INTEGER NOT NULL REFERENCES Materials (Id) ON DELETE CASCADE,
+ DrawingMetadataId INTEGER NOT NULL REFERENCES DrawingMetadata (Id) ON DELETE CASCADE
+);
+CREATE UNIQUE INDEX IX_BearingBlockConfigurations_PartNumber ON BearingBlockConfigurations (PartNumber);
diff --git a/docs/forge/artifacts/host-m2/validation-report.md b/docs/forge/artifacts/host-m2/validation-report.md
new file mode 100644
index 00000000..730230fa
--- /dev/null
+++ b/docs/forge/artifacts/host-m2/validation-report.md
@@ -0,0 +1,23 @@
+# Forge Host M2 validation evidence
+
+Seeded four configurations, two materials, and one shared Aster Works drawing-metadata row in a real SQLite database. The production-aluminium LINQ query selected `AB-204` then `AB-305` by bore diameter.
+
+| Part | Revision | Specialization | STEP SHA-256 |
+|---|---:|---|---|
+| AB-204 | 2.1.0 | `template:1d2e995f2be2e479` | `3ACD9BEA0CE21C5FDF7699A27128D8B11F05F4719C939746742AE1FC7C3F7259` |
+| AB-305 | 3.0.1 | `template:eea80ba75fd5599f` | `5764A7273643806522A13864BAF28C331D10B40C6E82FE513FB7FDEBB90BD4AF` |
+
+Two independent batch runs preserved query order, specialization identities, artifact names, and STEP hashes. Warm compilation for the second specialization was about 5 ms; first-process compiler/template initialization was about 230–252 ms. EF/SQLite first-query initialization was about 213–250 ms, while explicit DTO/Record mapping was 0.02–4.55 ms.
+
+`aetheris inspect` on AB-204 reported one enclosed-manifold body and shell, 7 faces, 15 edges, 12 vertices, 6 planar faces, 1 cylindrical face, 2 circular curves, and bounds `[-50,-30,0]` to `[50,30,16]` mm. This is the expected 100 x 60 x 16 block with an exact cylindrical through-bore.
+
+Focused validation:
+
+- Database-driven sample tests: 8 passed (SQLite schema/seed/join/query, unknown SKU, malformed revision, primitive/unit/nested Record binding, unsupported mapping, invalid Require, deterministic generation, dependency boundary).
+- Forge Host tests: 8 passed (native and extension invocation, generated binding, diagnostics, exact STEP round trip, CIR/provenance, resource handling).
+- Firmament Template/Drawing tests: 38 passed; CLI tests: 360 passed; FEA host-consumer tests: 12 passed.
+- `dotnet restore Aetheris.slnx` and `dotnet build Aetheris.slnx -f net10.0 --no-restore /m:1`: passed with 0 warnings and 0 errors.
+- NuGet vulnerability audit: no vulnerable direct or transitive packages for the sample.
+- Package boundary: KernelSDK absent directly and transitively from sample `project.assets.json`.
+- Drawing/PDF: not generated; the Drawing M0 API is still complete-source oriented and was not bridged with source generation.
+- Public docs site: no public-doc-site project is present in this repository; repository Forge docs were updated.
diff --git a/docs/forge/artifacts/m1/api-surface-summary.md b/docs/forge/artifacts/m1/api-surface-summary.md
index ff8c188e..8671fe2e 100644
--- a/docs/forge/artifacts/m1/api-surface-summary.md
+++ b/docs/forge/artifacts/m1/api-surface-summary.md
@@ -28,4 +28,4 @@
- `Aetheris.Forge.SampleExtension`: external/private capability and Firmament module.
- `Aetheris.Forge.SampleExtension.Bindings`: deterministic generated binding proof using the same host path.
-- `Aetheris.Forge.Sdk.Tests`: native Template invocation, full extension stack, deterministic output, collision/version/missing diagnostics, resources, CIR association.
+- `Aetheris.Forge.Host.Tests`: native Template invocation, full extension stack, deterministic output, collision/version/missing diagnostics, resources, CIR association.
diff --git a/docs/forge/artifacts/m1/current-forge-audit.md b/docs/forge/artifacts/m1/current-forge-audit.md
index 92e72ace..2315f4e8 100644
--- a/docs/forge/artifacts/m1/current-forge-audit.md
+++ b/docs/forge/artifacts/m1/current-forge-audit.md
@@ -10,7 +10,7 @@ Firmament already depended on Forge for runtime Concept validation. The CLI coul
Compiler invocation lived in `Aetheris.Kernel.Firmament` through file/source parsers and `FirmamentBuildAndExport`. Modern Template declarations were parsed into an internal immutable binder IR, specialized, and erased before AIR, but applications had to appear in Firmament source. InlineStep consumed canonical STEP through `Step242Importer` and preserved canonical hashes/topology maps.
-The accidental boundary pressure was that making the existing `Aetheris.Forge` assembly depend on the compiler would create a cycle (`Firmament -> Forge`). M1 therefore retained low-level contracts in `Aetheris.Forge`, exposed a narrow public Template-host bridge from Firmament, and added `Aetheris.Forge.Sdk` above the compiler. Existing Concept-pack behavior and legacy helpers remain compatible but are not the new construction-extension API.
+The accidental boundary pressure was that making the existing `Aetheris.Forge` assembly depend on the compiler would create a cycle (`Firmament -> Forge`). M1 therefore retained low-level contracts in `Aetheris.Forge`, exposed a narrow public Template-host bridge from Firmament, and added the then-named `Aetheris.Forge.Sdk` above the compiler. Host M2 subsequently split that surface into `Aetheris.Forge.Host` and `Aetheris.Forge.KernelSDK`. Existing Concept-pack behavior and legacy helpers remain compatible but are not the new construction-extension API.
Baseline classification:
diff --git a/docs/forge/database-driven-cad.md b/docs/forge/database-driven-cad.md
new file mode 100644
index 00000000..0fbf5e31
--- /dev/null
+++ b/docs/forge/database-driven-cad.md
@@ -0,0 +1,48 @@
+# Database-driven CAD with SQLite, LINQ, and Forge Host
+
+The `samples/Aetheris.Samples.DatabaseDrivenCad` console application proves a deliberately ordinary architecture:
+
+```text
+SQLite -> EF Core -> LINQ -> typed C# record -> Forge Host -> Firmament Template -> exact AP242 STEP
+```
+
+SQLite is authoritative for catalog and application configuration data. The compile-tested `BearingBlock.firmament` Template is authoritative for engineering generation logic. AP242 is the exact compiled geometry artifact; the database does not store BRep blobs.
+
+## Run it
+
+From the repository root:
+
+```powershell
+dotnet run --project samples/Aetheris.Samples.DatabaseDrivenCad -- seed
+dotnet run --project samples/Aetheris.Samples.DatabaseDrivenCad -- list
+dotnet run --project samples/Aetheris.Samples.DatabaseDrivenCad -- query
+dotnet run --project samples/Aetheris.Samples.DatabaseDrivenCad -- generate AB-204
+dotnet run --project samples/Aetheris.Samples.DatabaseDrivenCad -- generate-all
+```
+
+Use `--database PATH` and `--output DIR` for explicit locations. Dimensions and tolerances are stored in millimetres; the names make that convention explicit. `generate-all` executes the real relational LINQ query for production aluminium configurations with bore diameter at least 20 mm, orders by bore then part number, and compiles every selected row. Output paths derive from the database part number.
+
+The application maps its EF entity into `BearingBlockSpec`, whose dimensions use the public `Length` type and whose revision uses `System.Version`. `BearingBlockBinding.Descriptor` explicitly maps every field into a `ForgeRecord`; it uses no reflection, JSON, anonymous object serialization, or Firmament source construction. `ForgeInvocation.WithProvenance` records the database kind, entity, and key without a machine-local database path.
+
+The Template constructs a real box and resolved through-bore, validates positive dimensions and bore/tolerance admissibility, and exports STEP through the normal compiler path. `ForgeCompilationResult` returns typed diagnostics and the stable Template specialization identity. Drawing/PDF generation is not included: the current Drawing M0 compiler consumes a complete source document rather than the Host Template result seam, and duplicating or source-generating a drawing document would violate this sample's boundary.
+
+## LINQ is the configuration query language
+
+The sample includes ordinary EF Core queries for:
+
+- all configurations ordered by bore and part number;
+- one SKU by `PartNumber`;
+- production aluminium configurations joined through `Material` with a minimum bore;
+- current configurations by semantic-version major component.
+
+It intentionally does not wrap LINQ in an Aetheris query API.
+
+## Static Tables versus SQLite
+
+Firmament Static Tables remain appropriate for finite engineering standards and configuration that belongs with source and version control. SQLite is appropriate for runtime catalog, product, and business configuration queried by an application. One does not make the other obsolete.
+
+## Scope
+
+This sample demonstrates catalog data, variant querying, deterministic generation, and exact artifacts. It does not claim to implement approvals, permissions, audit/compliance, ECO workflows, supplier portals, ERP, or full PLM.
+
+Compared with a spreadsheet configurator, responsibilities remain separate: SQLite stores relational data, LINQ expresses queries, C# owns application flow, Firmament owns engineering generation, Git owns source history, and STEP is a compiled artifact. No Excel, VBA, named ranges, proprietary query language, or KernelSDK dependency is involved.
diff --git a/docs/forge/invocation-sdk.md b/docs/forge/invocation-sdk.md
index e3f64f28..be36d79b 100644
--- a/docs/forge/invocation-sdk.md
+++ b/docs/forge/invocation-sdk.md
@@ -1,6 +1,6 @@
-# Forge invocation SDK
+# Forge Host invocation API
-`Aetheris.Forge.Sdk` exposes the host workflow `ForgeHost -> ForgeModule -> ForgeTemplate -> ForgeInvocation -> ForgeCompilationResult`.
+`Aetheris.Forge.Host` exposes the host workflow `ForgeHost -> ForgeModule -> ForgeTemplate -> ForgeInvocation -> ForgeCompilationResult`.
## Typed Template invocation
diff --git a/docs/forge/kernel-sdk-migration.md b/docs/forge/kernel-sdk-migration.md
new file mode 100644
index 00000000..2a6a72c2
--- /dev/null
+++ b/docs/forge/kernel-sdk-migration.md
@@ -0,0 +1,17 @@
+# Forge SDK package migration
+
+The former `Aetheris.Forge.Sdk` name mixed two audiences and has been removed before a stable NuGet release made compatibility forwarding necessary.
+
+Use:
+
+- `Aetheris.Forge.Host` for application-side loading, typed Template invocation, compilation, diagnostics, specialization identity, provenance, and generated artifacts.
+- `Aetheris.Forge.KernelSDK` for advanced construction/semantic/compiler capability development and Aetheris kernel prototyping.
+- `Aetheris.Forge` for the low-level contracts that sit below Firmament; application code should normally reach them through one of the packages above.
+
+Migration:
+
+1. Ordinary host applications replace the project/package reference with `Aetheris.Forge.Host` and change `using Aetheris.Forge.Sdk;` to `using Aetheris.Forge.Host;`.
+2. Extension implementations replace the reference with `Aetheris.Forge.KernelSDK`. Existing extension contract namespaces remain under `Aetheris.Forge.*` so capability code does not need a cosmetic namespace rewrite.
+3. Generated binding packages reference `Aetheris.Forge.Host`; they should not pull KernelSDK into their consumers.
+
+No compatibility package is retained. The old project had not reached a stable package contract, and a forwarding package would preserve the ambiguous dependency boundary the rename is intended to remove.
diff --git a/docs/preview2/evidence/docsite-m2/build-test-results.md b/docs/preview2/evidence/docsite-m2/build-test-results.md
index c6586425..70daf8be 100644
--- a/docs/preview2/evidence/docsite-m2/build-test-results.md
+++ b/docs/preview2/evidence/docsite-m2/build-test-results.md
@@ -8,7 +8,7 @@ Validated 2026-08-09 on Windows with .NET SDK 10.0.203, TSPack 0.1.8, Vite 6.4.3
- `dotnet build Aetheris.slnx -f net10.0 --no-restore /m:1`: passed, 0 warnings, 0 errors.
- `Aetheris.Kernel.Firmament.Tests`: 1,077 passed.
- `Aetheris.Semantics.Tests`: 9 passed.
-- `Aetheris.Forge.Sdk.Tests`: 8 passed.
+- `Aetheris.Forge.Host.Tests`: 8 passed.
- `Aetheris.FEA.Tests`: 12 passed.
- `Aetheris.CLI.Tests`: 355 passed.
- Total targeted tests: 1,461 passed, 0 failed, 0 skipped.
diff --git a/docs/preview2/evidence/docsite-m2/claim-map.csv b/docs/preview2/evidence/docsite-m2/claim-map.csv
index 6beb4e60..7dbccac8 100644
--- a/docs/preview2/evidence/docsite-m2/claim-map.csv
+++ b/docs/preview2/evidence/docsite-m2/claim-map.csv
@@ -3,7 +3,7 @@ Firmament is statically evaluated compiler metaprogramming,docs/firmament-v2/lan
tolerance does not perturb nominal geometry,docs/firmament-v2/language-reference.md,/aetheris/firmament/values-tolerances
SemanticValue is origin-independent,docs/semantic/architecture.md + Aetheris.Semantics.Tests,/aetheris/firmament/semantics
recognition is bounded and not arbitrary history recovery,language reference + InlineStep tests,/aetheris/firmament/inline-step
-Forge host performs typed Template invocation,docs/forge/invocation-sdk.md + Aetheris.Forge.Sdk.Tests,/aetheris/forge/host-sdk
+Forge host performs typed Template invocation,docs/forge/invocation-sdk.md + Aetheris.Forge.Host.Tests,/aetheris/forge/host-sdk
Forge extension can return exact BRep CIR and semantic members,Aetheris.Forge.SampleExtension + Forge SDK tests,/aetheris/forge/extension-sdk
SurfaceMeshIR precedes OBJ/STL triangulation,Preview 2 mesh evidence + current CLI run,/aetheris/geometry/surface-mesh-ir
BRep and CIR dual-lower from shared intent,docs/preview2/feature-manifest.json,/aetheris/analysis/continuum
diff --git a/samples/Aetheris.Samples.DatabaseDrivenCad.Tests/Aetheris.Samples.DatabaseDrivenCad.Tests.csproj b/samples/Aetheris.Samples.DatabaseDrivenCad.Tests/Aetheris.Samples.DatabaseDrivenCad.Tests.csproj
new file mode 100644
index 00000000..7fd7c424
--- /dev/null
+++ b/samples/Aetheris.Samples.DatabaseDrivenCad.Tests/Aetheris.Samples.DatabaseDrivenCad.Tests.csproj
@@ -0,0 +1,20 @@
+<Project Sdk="Microsoft.NET.Sdk">
+ <PropertyGroup>
+ <TargetFramework>net10.0</TargetFramework>
+ <ImplicitUsings>enable</ImplicitUsings>
+ <Nullable>enable</Nullable>
+ <IsPackable>false</IsPackable>
+ </PropertyGroup>
+ <ItemGroup>
+ <PackageReference Include="coverlet.collector" Version="6.0.0" />
+ <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.11.1" />
+ <PackageReference Include="xunit" Version="2.9.2" />
+ <PackageReference Include="xunit.runner.visualstudio" Version="2.8.2" />
+ </ItemGroup>
+ <ItemGroup>
+ <Using Include="Xunit" />
+ </ItemGroup>
+ <ItemGroup>
+ <ProjectReference Include="..\Aetheris.Samples.DatabaseDrivenCad\Aetheris.Samples.DatabaseDrivenCad.csproj" />
+ </ItemGroup>
+</Project>
diff --git a/samples/Aetheris.Samples.DatabaseDrivenCad.Tests/DatabaseDrivenCadTests.cs b/samples/Aetheris.Samples.DatabaseDrivenCad.Tests/DatabaseDrivenCadTests.cs
new file mode 100644
index 00000000..817d3ad9
--- /dev/null
+++ b/samples/Aetheris.Samples.DatabaseDrivenCad.Tests/DatabaseDrivenCadTests.cs
@@ -0,0 +1,194 @@
+using System.Text.Json;
+using Aetheris.Forge.Host;
+using Microsoft.EntityFrameworkCore;
+
+namespace Aetheris.Samples.DatabaseDrivenCad.Tests;
+
+public sealed class DatabaseDrivenCadTests : IDisposable
+{
+ private readonly string directory = Path.Combine(Path.GetTempPath(), $"aetheris-database-cad-{Guid.NewGuid():N}");
+
+ [Fact]
+ public async Task RealSqliteSchemaSeedAndRelationalLinqQueriesAreDeterministic()
+ {
+ await using var database = ProductCatalog.Open(Path.Combine(directory, "products.sqlite"));
+ await ProductCatalog.SeedAsync(database);
+
+ Assert.True(await database.Database.CanConnectAsync());
+ Assert.Equal(4, await database.BearingBlockConfigurations.CountAsync());
+ Assert.Equal(2, await database.Materials.CountAsync());
+ var aluminum = await ProductCatalog.ProductionAluminum(database).Select(item => new { item.PartNumber, item.Material.Grade }).ToArrayAsync();
+ Assert.Equal(new[] { "AB-204", "AB-305" }, aluminum.Select(item => item.PartNumber));
+ Assert.All(aluminum, item => Assert.Equal("6061-T6", item.Grade));
+ var majorTwo = await ProductCatalog.CurrentMajor(database, 2).Select(item => item.PartNumber).ToArrayAsync();
+ Assert.Equal(["AB-204"], majorTwo);
+ var sku = await ProductCatalog.WithRelations(database).SingleAsync(item => item.PartNumber == "AB-204");
+ Assert.Equal("Aster Works", sku.DrawingMetadata.Company);
+ }
+
+ [Fact]
+ public async Task DatabaseRowCompilesThroughTypedRecordAndBatchPathsAreDeterministic()
+ {
+ await using var database = ProductCatalog.Open(Path.Combine(directory, "products.sqlite"));
+ await ProductCatalog.SeedAsync(database);
+ var rows = await ProductCatalog.ProductionAluminum(database).ToArrayAsync();
+ var generator = new BearingBlockGenerator();
+
+ var first = rows.Select(row => generator.Generate(row, Path.Combine(directory, "first"))).ToArray();
+ var second = rows.Select(row => generator.Generate(row, Path.Combine(directory, "second"))).ToArray();
+
+ Assert.Equal(new[] { "AB-204", "AB-305" }, first.Select(item => item.PartNumber));
+ Assert.Equal(first.Select(item => item.TemplateSpecialization), second.Select(item => item.TemplateSpecialization));
+ Assert.Equal(first.Select(item => item.StepSha256), second.Select(item => item.StepSha256));
+ Assert.All(first, item =>
+ {
+ Assert.True(File.Exists(item.StepPath));
+ Assert.Contains("ISO-10303-21", File.ReadAllText(item.StepPath), StringComparison.Ordinal);
+ Assert.Equal(Path.Combine(directory, "first", item.PartNumber, item.PartNumber + ".step"), item.StepPath);
+ });
+ }
+
+ [Fact]
+ public async Task InvalidConfigurationSurfacesFirmamentRequireDiagnostic()
+ {
+ await using var database = ProductCatalog.Open(Path.Combine(directory, "products.sqlite"));
+ await ProductCatalog.SeedAsync(database);
+ var row = await ProductCatalog.WithRelations(database).SingleAsync(item => item.PartNumber == "AB-204");
+ row.BoreDiameterMillimeters = row.WidthMillimeters;
+
+ var exception = Assert.Throws<InvalidOperationException>(() => new BearingBlockGenerator().Generate(row, Path.Combine(directory, "invalid")));
+ Assert.Contains("require", exception.Message, StringComparison.OrdinalIgnoreCase);
+ }
+
+ [Fact]
+ public async Task UnknownSkuAndMalformedRevisionAreRejected()
+ {
+ await using var database = ProductCatalog.Open(Path.Combine(directory, "products.sqlite"));
+ await ProductCatalog.SeedAsync(database);
+ Assert.Empty(await ProductCatalog.WithRelations(database).Where(item => item.PartNumber == "UNKNOWN").ToArrayAsync());
+
+ var row = await ProductCatalog.WithRelations(database).SingleAsync(item => item.PartNumber == "AB-204");
+ row.RevisionMajor = -1;
+ Assert.Throws<ArgumentOutOfRangeException>(() => BearingBlockBinding.ToSpec(row));
+ }
+
+ [Fact]
+ public void SampleDependencyGraphExcludesKernelSdkDirectlyAndTransitively()
+ {
+ var root = FindRepositoryRoot();
+ var project = File.ReadAllText(Path.Combine(root, "samples", "Aetheris.Samples.DatabaseDrivenCad", "Aetheris.Samples.DatabaseDrivenCad.csproj"));
+ Assert.DoesNotContain("Aetheris.Forge.KernelSDK", project, StringComparison.OrdinalIgnoreCase);
+
+ var assetsPath = Path.Combine(root, "samples", "Aetheris.Samples.DatabaseDrivenCad", "obj", "project.assets.json");
+ Assert.True(File.Exists(assetsPath), "Restore must create project.assets.json before the boundary test runs.");
+ using var assets = JsonDocument.Parse(File.ReadAllText(assetsPath));
+ var libraries = assets.RootElement.GetProperty("libraries").EnumerateObject().Select(item => item.Name).ToArray();
+ Assert.DoesNotContain(libraries, item => item.Contains("Aetheris.Forge.KernelSDK", StringComparison.OrdinalIgnoreCase));
+ Assert.Contains(libraries, item => item.Contains("Aetheris.Forge.Host", StringComparison.OrdinalIgnoreCase));
+ }
+
+ [Fact]
+ public void ExplicitRecordMappingSupportsPrimitivesUnitsNestedRecordsAndCanonicalOrder()
+ {
+ var child = new ForgeRecordDescriptor<Child>("Child", new Dictionary<string, Func<Child, ForgeValue>>
+ {
+ ["Name"] = value => ForgeValue.From(value.Name),
+ ["Enabled"] = value => ForgeValue.From(value.Enabled),
+ });
+ var parent = new ForgeRecordDescriptor<Parent>("Parent", new Dictionary<string, Func<Parent, ForgeValue>>
+ {
+ ["Revision"] = value => ForgeValue.From(value.Revision),
+ ["Length"] = value => ForgeValue.From(value.Length),
+ ["Count"] = value => ForgeValue.From(value.Count),
+ ["Child"] = value => child.Map(value.Child),
+ });
+
+ var mapped = parent.Map(new(new Length(12.5), 3, new Version(2, 1, 0), new(true, "nested")));
+ Assert.Equal(new[] { "Child", "Count", "Length", "Revision" }, mapped.Fields.Keys);
+ Assert.IsType<ForgeRecord>(mapped.Fields["Child"]);
+ Assert.Equal(12.5, Assert.IsType<ForgeLength>(mapped.Fields["Length"]).Millimeters);
+ Assert.Equal(new Version(2, 1, 0), Assert.IsType<ForgeVersion>(mapped.Fields["Revision"]).Value);
+ }
+
+ [Fact]
+ public void NestedRecordCompilesThroughFirmamentBinderWithoutSourceGeneration()
+ {
+ const string source = """
+ Record Dimensions { Width: Length Height: Length Depth: Length }
+ Record ProductSpec { Dimensions: Dimensions }
+ Concept ProductConcept {
+ Bounds: Box3
+ TopPlane: Plane
+ ChamferDistance: Length
+ }
+ Template < Spec: ProductSpec >
+ Struct Product: ProductConcept {
+ Require Positive => Spec.Dimensions.Width > 0mm && Spec.Dimensions.Height > 0mm && Spec.Dimensions.Depth > 0mm
+ Concept Struct Design: ProductConcept {
+ Bounds: Box3 { Size: [Spec.Dimensions.Width, Spec.Dimensions.Height, Spec.Dimensions.Depth] }
+ TopPlane: Bounds.Face(+Z)
+ ChamferDistance: 1mm
+ }
+ Box Body { Bounds: Design.Bounds }
+ Modify Body {
+ EdgeFinish TopBreak {
+ Face: Design.TopPlane
+ Target: Boundary
+ Kind: Chamfer
+ Distance: Design.ChamferDistance
+ }
+ }
+ Expose {
+ Bounds: Design.Bounds
+ TopPlane: Body.Top
+ ChamferDistance: Design.ChamferDistance
+ }
+ }
+ """;
+ var dimensions = new ForgeRecordDescriptor<Dimensions>("Dimensions", new Dictionary<string, Func<Dimensions, ForgeValue>>
+ {
+ ["Width"] = value => ForgeValue.From(value.Width),
+ ["Height"] = value => ForgeValue.From(value.Height),
+ ["Depth"] = value => ForgeValue.From(value.Depth),
+ });
+ var product = new ForgeRecordDescriptor<Product>("ProductSpec", new Dictionary<string, Func<Product, ForgeValue>>
+ {
+ ["Dimensions"] = value => dimensions.Map(value.Dimensions),
+ });
+
+ var result = new ForgeHost().LoadModule("Nested", source).ResolveTemplate("Product").Invoke("NestedBox")
+ .Bind("Spec", product.Map(new(new(new Length(20), new Length(12), new Length(5)))))
+ .Compile();
+
+ Assert.True(result.IsSuccess, string.Join(Environment.NewLine, result.Diagnostics.Select(item => item.Message)));
+ Assert.Contains("ISO-10303-21", result.Artifact!.StepText, StringComparison.Ordinal);
+ }
+
+ [Fact]
+ public void UnsupportedNullMappingIsRejectedDeterministically()
+ {
+ var descriptor = new ForgeRecordDescriptor<string>("Bad", new Dictionary<string, Func<string, ForgeValue>>
+ {
+ ["Unsupported"] = _ => null!,
+ });
+ var exception = Assert.Throws<InvalidOperationException>(() => descriptor.Map("value"));
+ Assert.Equal("Mapper for field 'Unsupported' returned null.", exception.Message);
+ }
+
+ public void Dispose()
+ {
+ if (Directory.Exists(directory)) Directory.Delete(directory, true);
+ }
+
+ private static string FindRepositoryRoot()
+ {
+ var current = new DirectoryInfo(AppContext.BaseDirectory);
+ while (current is not null && !File.Exists(Path.Combine(current.FullName, "Aetheris.slnx"))) current = current.Parent;
+ return current?.FullName ?? throw new DirectoryNotFoundException("Repository root not found.");
+ }
+
+ private sealed record Child(bool Enabled, string Name);
+ private sealed record Parent(Length Length, int Count, Version Revision, Child Child);
+ private sealed record Dimensions(Length Width, Length Height, Length Depth);
+ private sealed record Product(Dimensions Dimensions);
+}
diff --git a/samples/Aetheris.Samples.DatabaseDrivenCad/Aetheris.Samples.DatabaseDrivenCad.csproj b/samples/Aetheris.Samples.DatabaseDrivenCad/Aetheris.Samples.DatabaseDrivenCad.csproj
new file mode 100644
index 00000000..ca29650f
--- /dev/null
+++ b/samples/Aetheris.Samples.DatabaseDrivenCad/Aetheris.Samples.DatabaseDrivenCad.csproj
@@ -0,0 +1,16 @@
+<Project Sdk="Microsoft.NET.Sdk">
+ <PropertyGroup>
+ <OutputType>Exe</OutputType>
+ <TargetFramework>net10.0</TargetFramework>
+ <ImplicitUsings>enable</ImplicitUsings>
+ <Nullable>enable</Nullable>
+ </PropertyGroup>
+ <ItemGroup>
+ <PackageReference Include="Microsoft.EntityFrameworkCore.Sqlite" Version="10.0.0" />
+ <PackageReference Include="SQLitePCLRaw.bundle_e_sqlite3" Version="3.0.5" />
+ <ProjectReference Include="..\..\Aetheris.Forge.Host\Aetheris.Forge.Host.csproj" />
+ </ItemGroup>
+ <ItemGroup>
+ <None Include="Templates\BearingBlock.firmament" CopyToOutputDirectory="PreserveNewest" />
+ </ItemGroup>
+</Project>
diff --git a/samples/Aetheris.Samples.DatabaseDrivenCad/BearingBlockGeneration.cs b/samples/Aetheris.Samples.DatabaseDrivenCad/BearingBlockGeneration.cs
new file mode 100644
index 00000000..c714c1f6
--- /dev/null
+++ b/samples/Aetheris.Samples.DatabaseDrivenCad/BearingBlockGeneration.cs
@@ -0,0 +1,109 @@
+using System.Diagnostics;
+using System.Security.Cryptography;
+using System.Text;
+using System.Text.Json;
+using Aetheris.Forge.Host;
+
+namespace Aetheris.Samples.DatabaseDrivenCad;
+
+public sealed record BearingBlockSpec(
+ Length Width,
+ Length Height,
+ Length Depth,
+ Length BoreDiameter,
+ Length BoreRadius,
+ Length BoreTolerancePlus,
+ Length BoreToleranceMinus,
+ string Material,
+ string PartNumber,
+ Version Revision,
+ string Company,
+ string Author,
+ string Description);
+
+public sealed record GeneratedProduct(
+ string PartNumber,
+ string TemplateSpecialization,
+ string StepPath,
+ string StepSha256,
+ IReadOnlyList<ForgeDiagnostic> Diagnostics,
+ double MappingMilliseconds,
+ double CompilationMilliseconds);
+
+public static class BearingBlockBinding
+{
+ public static readonly ForgeRecordDescriptor<BearingBlockSpec> Descriptor = new(
+ "BearingBlockSpec",
+ new Dictionary<string, Func<BearingBlockSpec, ForgeValue>>(StringComparer.Ordinal)
+ {
+ ["Author"] = value => ForgeValue.From(value.Author),
+ ["BoreDiameter"] = value => ForgeValue.From(value.BoreDiameter),
+ ["BoreRadius"] = value => ForgeValue.From(value.BoreRadius),
+ ["BoreToleranceMinus"] = value => ForgeValue.From(value.BoreToleranceMinus),
+ ["BoreTolerancePlus"] = value => ForgeValue.From(value.BoreTolerancePlus),
+ ["Company"] = value => ForgeValue.From(value.Company),
+ ["Depth"] = value => ForgeValue.From(value.Depth),
+ ["Description"] = value => ForgeValue.From(value.Description),
+ ["Height"] = value => ForgeValue.From(value.Height),
+ ["Material"] = value => ForgeValue.From(value.Material),
+ ["PartNumber"] = value => ForgeValue.From(value.PartNumber),
+ ["Revision"] = value => ForgeValue.From(value.Revision),
+ ["Width"] = value => ForgeValue.From(value.Width),
+ });
+
+ public static BearingBlockSpec ToSpec(BearingBlockConfiguration row) => new(
+ new(row.WidthMillimeters), new(row.HeightMillimeters), new(row.DepthMillimeters),
+ new(row.BoreDiameterMillimeters), new(row.BoreDiameterMillimeters / 2), new(row.BoreTolerancePlusMillimeters), new(row.BoreToleranceMinusMillimeters),
+ row.Material.Grade, row.PartNumber,
+ new Version(row.RevisionMajor, row.RevisionMinor, row.RevisionPatch),
+ row.DrawingMetadata.Company, row.DrawingMetadata.Author, row.DrawingMetadata.Description);
+
+ public static ForgeInvocation CreateInvocation(ForgeModule module, BearingBlockSpec spec) =>
+ module.ResolveTemplate("BearingBlock")
+ .Invoke(spec.PartNumber.Replace("-", "_", StringComparison.Ordinal))
+ .Bind("Spec", Descriptor.Map(spec))
+ .WithProvenance("database", "products.sqlite", $"Entity=BearingBlockConfiguration;Key={spec.PartNumber}");
+}
+
+public sealed class BearingBlockGenerator
+{
+ private readonly ForgeModule module;
+
+ public BearingBlockGenerator()
+ {
+ var templatePath = Path.Combine(AppContext.BaseDirectory, "Templates", "BearingBlock.firmament");
+ module = new ForgeHost().LoadModule(templatePath);
+ }
+
+ public GeneratedProduct Generate(BearingBlockConfiguration row, string outputRoot)
+ {
+ var mappingStart = Stopwatch.GetTimestamp();
+ var spec = BearingBlockBinding.ToSpec(row);
+ var invocation = BearingBlockBinding.CreateInvocation(module, spec);
+ var mappingTime = Stopwatch.GetElapsedTime(mappingStart);
+ var compileStart = Stopwatch.GetTimestamp();
+ var result = invocation.Compile();
+ var compileTime = Stopwatch.GetElapsedTime(compileStart);
+ if (!result.IsSuccess || result.Artifact is null)
+ throw new InvalidOperationException($"Forge compilation failed for {row.PartNumber}: " + string.Join("; ", result.Diagnostics.Select(item => $"{item.Code}: {item.Message}")));
+
+ var directory = Path.Combine(Path.GetFullPath(outputRoot), row.PartNumber);
+ Directory.CreateDirectory(directory);
+ var stepPath = Path.Combine(directory, row.PartNumber + ".step");
+ File.WriteAllText(stepPath, result.Artifact.StepText, new UTF8Encoding(false));
+ return new GeneratedProduct(
+ row.PartNumber,
+ result.TemplateSpecializationIdentity ?? throw new InvalidOperationException("Host did not return Template specialization identity."),
+ stepPath,
+ Convert.ToHexString(SHA256.HashData(Encoding.UTF8.GetBytes(result.Artifact.StepText))),
+ result.Diagnostics,
+ mappingTime.TotalMilliseconds,
+ compileTime.TotalMilliseconds);
+ }
+
+ public static void WriteManifest(string outputRoot, IReadOnlyList<GeneratedProduct> products) =>
+ File.WriteAllText(
+ Path.Combine(Path.GetFullPath(outputRoot), "manifest.json"),
+ JsonSerializer.Serialize(products, new JsonSerializerOptions { WriteIndented = true }),
+ new UTF8Encoding(false));
+}
diff --git a/samples/Aetheris.Samples.DatabaseDrivenCad/Catalog.cs b/samples/Aetheris.Samples.DatabaseDrivenCad/Catalog.cs
new file mode 100644
index 00000000..e8ed8a51
--- /dev/null
+++ b/samples/Aetheris.Samples.DatabaseDrivenCad/Catalog.cs
@@ -0,0 +1,120 @@
+using Microsoft.EntityFrameworkCore;
+
+namespace Aetheris.Samples.DatabaseDrivenCad;
+
+public sealed class Material
+{
+ public int Id { get; set; }
+ public required string Name { get; set; }
+ public required string Grade { get; set; }
+ public bool IsAluminum { get; set; }
+ public ICollection<BearingBlockConfiguration> Configurations { get; } = [];
+}
+
+public sealed class DrawingMetadata
+{
+ public int Id { get; set; }
+ public required string Company { get; set; }
+ public required string Author { get; set; }
+ public required string Description { get; set; }
+ public ICollection<BearingBlockConfiguration> Configurations { get; } = [];
+}
+
+public sealed class BearingBlockConfiguration
+{
+ public int Id { get; set; }
+ public required string PartNumber { get; set; }
+ public double WidthMillimeters { get; set; }
+ public double HeightMillimeters { get; set; }
+ public double DepthMillimeters { get; set; }
+ public double BoreDiameterMillimeters { get; set; }
+ public double BoreTolerancePlusMillimeters { get; set; }
+ public double BoreToleranceMinusMillimeters { get; set; }
+ public int RevisionMajor { get; set; }
+ public int RevisionMinor { get; set; }
+ public int RevisionPatch { get; set; }
+ public bool IsProduction { get; set; }
+ public bool IsCurrent { get; set; }
+ public int MaterialId { get; set; }
+ public required Material Material { get; set; }
+ public int DrawingMetadataId { get; set; }
+ public required DrawingMetadata DrawingMetadata { get; set; }
+}
+
+public sealed class ProductCatalogContext(DbContextOptions<ProductCatalogContext> options) : DbContext(options)
+{
+ public DbSet<Material> Materials => Set<Material>();
+ public DbSet<DrawingMetadata> DrawingMetadata => Set<DrawingMetadata>();
+ public DbSet<BearingBlockConfiguration> BearingBlockConfigurations => Set<BearingBlockConfiguration>();
+
+ protected override void OnModelCreating(ModelBuilder modelBuilder)
+ {
+ modelBuilder.Entity<Material>().HasIndex(item => item.Grade).IsUnique();
+ modelBuilder.Entity<BearingBlockConfiguration>().HasIndex(item => item.PartNumber).IsUnique();
+ modelBuilder.Entity<BearingBlockConfiguration>()
+ .HasOne(item => item.Material).WithMany(item => item.Configurations).HasForeignKey(item => item.MaterialId);
+ modelBuilder.Entity<BearingBlockConfiguration>()
+ .HasOne(item => item.DrawingMetadata).WithMany(item => item.Configurations).HasForeignKey(item => item.DrawingMetadataId);
+ }
+}
+
+public static class ProductCatalog
+{
+ public static ProductCatalogContext Open(string databasePath)
+ {
+ var fullPath = Path.GetFullPath(databasePath);
+ Directory.CreateDirectory(Path.GetDirectoryName(fullPath)!);
+ var options = new DbContextOptionsBuilder<ProductCatalogContext>()
+ .UseSqlite($"Data Source={fullPath};Pooling=False")
+ .Options;
+ return new ProductCatalogContext(options);
+ }
+
+ public static async Task SeedAsync(ProductCatalogContext database, CancellationToken cancellationToken = default)
+ {
+ await database.Database.EnsureDeletedAsync(cancellationToken);
+ await database.Database.EnsureCreatedAsync(cancellationToken);
+
+ var aluminum = new Material { Name = "Aluminium 6061-T6", Grade = "6061-T6", IsAluminum = true };
+ var steel = new Material { Name = "Alloy steel 4140", Grade = "4140", IsAluminum = false };
+ var drawing = new DrawingMetadata { Company = "Aster Works", Author = "CAD Automation", Description = "Production bearing block" };
+ database.AddRange(aluminum, steel, drawing);
+ database.BearingBlockConfigurations.AddRange(
+ Config("AB-101", 80, 50, 12, 18, aluminum, drawing, 1, 0, 0, true, true),
+ Config("AB-204", 100, 60, 16, 24, aluminum, drawing, 2, 1, 0, true, true),
+ Config("AB-305", 120, 70, 20, 30, aluminum, drawing, 3, 0, 1, true, true),
+ Config("SB-210", 100, 60, 18, 22, steel, drawing, 2, 0, 0, true, false));
+ await database.SaveChangesAsync(cancellationToken);
+ }
+
+ public static IQueryable<BearingBlockConfiguration> WithRelations(ProductCatalogContext database) =>
+ database.BearingBlockConfigurations.AsNoTracking().Include(item => item.Material).Include(item => item.DrawingMetadata);
+
+ public static IQueryable<BearingBlockConfiguration> ProductionAluminum(ProductCatalogContext database, double minimumBoreMillimeters = 20) =>
+ WithRelations(database)
+ .Where(item => item.IsProduction && item.Material.IsAluminum && item.BoreDiameterMillimeters >= minimumBoreMillimeters)
+ .OrderBy(item => item.BoreDiameterMillimeters).ThenBy(item => item.PartNumber);
+
+ public static IQueryable<BearingBlockConfiguration> CurrentMajor(ProductCatalogContext database, int major) =>
+ WithRelations(database).Where(item => item.IsCurrent && item.RevisionMajor == major).OrderBy(item => item.PartNumber);
+
+ private static BearingBlockConfiguration Config(
+ string partNumber, double width, double height, double depth, double bore,
+ Material material, DrawingMetadata drawing, int major, int minor, int patch, bool production, bool current) => new()
+ {
+ PartNumber = partNumber,
+ WidthMillimeters = width,
+ HeightMillimeters = height,
+ DepthMillimeters = depth,
+ BoreDiameterMillimeters = bore,
+ BoreTolerancePlusMillimeters = 0.05,
+ BoreToleranceMinusMillimeters = 0.02,
+ Material = material,
+ DrawingMetadata = drawing,
+ RevisionMajor = major,
+ RevisionMinor = minor,
+ RevisionPatch = patch,
+ IsProduction = production,
+ IsCurrent = current,
+ };
+}
diff --git a/samples/Aetheris.Samples.DatabaseDrivenCad/Program.cs b/samples/Aetheris.Samples.DatabaseDrivenCad/Program.cs
new file mode 100644
index 00000000..3441af9b
--- /dev/null
+++ b/samples/Aetheris.Samples.DatabaseDrivenCad/Program.cs
@@ -0,0 +1,76 @@
+using System.Diagnostics;
+using Microsoft.EntityFrameworkCore;
+using Aetheris.Samples.DatabaseDrivenCad;
+
+var parsed = CommandLine.Parse(args);
+if (parsed.Command is null) { CommandLine.Usage(); return 1; }
+await using var database = ProductCatalog.Open(parsed.DatabasePath);
+
+if (parsed.Command == "seed")
+{
+ await ProductCatalog.SeedAsync(database);
+ Console.WriteLine($"Seeded 4 configurations in {Path.GetFullPath(parsed.DatabasePath)}");
+ return 0;
+}
+if (!await database.Database.CanConnectAsync())
+{
+ Console.Error.WriteLine("Database is missing. Run 'seed' first.");
+ return 2;
+}
+
+IQueryable<BearingBlockConfiguration> query = parsed.Command switch
+{
+ "list" => ProductCatalog.WithRelations(database).OrderBy(item => item.BoreDiameterMillimeters).ThenBy(item => item.PartNumber),
+ "query" or "generate-query" or "generate-all" => ProductCatalog.ProductionAluminum(database),
+ "show" or "generate" when parsed.PartNumber is not null => ProductCatalog.WithRelations(database).Where(item => item.PartNumber == parsed.PartNumber),
+ _ => throw new ArgumentException($"Unknown or incomplete command '{parsed.Command}'."),
+};
+
+var queryStart = Stopwatch.GetTimestamp();
+var rows = await query.ToListAsync();
+var queryTime = Stopwatch.GetElapsedTime(queryStart);
+if (rows.Count == 0)
+{
+ Console.Error.WriteLine(parsed.PartNumber is null ? "Query selected no configurations." : $"Unknown part number '{parsed.PartNumber}'.");
+ return 3;
+}
+
+if (parsed.Command is "list" or "query" or "show")
+{
+ Console.WriteLine("PartNumber Width Height Depth Bore Material Revision");
+ foreach (var row in rows)
+ Console.WriteLine($"{row.PartNumber,-11} {row.WidthMillimeters,5:0.##} {row.HeightMillimeters,6:0.##} {row.DepthMillimeters,5:0.##} {row.BoreDiameterMillimeters,4:0.##} {row.Material.Grade,-8} {row.RevisionMajor}.{row.RevisionMinor}.{row.RevisionPatch}");
+ Console.WriteLine($"SQLite/LINQ: {queryTime.TotalMilliseconds:F2} ms; rows: {rows.Count}");
+ return 0;
+}
+
+var generator = new BearingBlockGenerator();
+var generated = rows.Select(row => generator.Generate(row, parsed.OutputPath)).ToArray();
+BearingBlockGenerator.WriteManifest(parsed.OutputPath, generated);
+foreach (var item in generated)
+{
+ Console.WriteLine($"{item.PartNumber}: {item.TemplateSpecialization}");
+ Console.WriteLine($" STEP {item.StepPath}");
+ Console.WriteLine($" SHA256 {item.StepSha256}");
+ Console.WriteLine($" mapping {item.MappingMilliseconds:F2} ms; compile+STEP {item.CompilationMilliseconds:F2} ms");
+}
+Console.WriteLine($"SQLite/LINQ: {queryTime.TotalMilliseconds:F2} ms; generated: {generated.Length}");
+return 0;
+
+internal sealed record CommandLine(string? Command, string? PartNumber, string DatabasePath, string OutputPath)
+{
+ public static CommandLine Parse(string[] args)
+ {
+ var positional = args.Where(value => !value.StartsWith("--", StringComparison.Ordinal)).ToArray();
+ string Option(string name, string fallback)
+ {
+ var index = Array.IndexOf(args, name);
+ return index >= 0 && index + 1 < args.Length ? args[index + 1] : fallback;
+ }
+ var command = positional.FirstOrDefault();
+ var part = command is "show" or "generate" ? positional.Skip(1).FirstOrDefault() : null;
+ return new(command, part, Option("--database", Path.Combine(Environment.CurrentDirectory, "products.sqlite")), Option("--output", Path.Combine(Environment.CurrentDirectory, "output")));
+ }
+
+ public static void Usage() => Console.WriteLine("Usage: database-cad <seed|list|query|show SKU|generate SKU|generate-all|generate-query> [--database PATH] [--output DIR]");
+}
diff --git a/samples/Aetheris.Samples.DatabaseDrivenCad/Templates/BearingBlock.firmament b/samples/Aetheris.Samples.DatabaseDrivenCad/Templates/BearingBlock.firmament
new file mode 100644
index 00000000..84ac679a
--- /dev/null
+++ b/samples/Aetheris.Samples.DatabaseDrivenCad/Templates/BearingBlock.firmament
@@ -0,0 +1,64 @@
+Model DatabaseBearingBlock {
+ Units: mm
+
+ Concept BearingBlockConcept {
+ Bounds: Box3
+ TopPlane: Plane
+ BoreCenters: Point3[]
+ BoreDiameter: Length
+ }
+
+ Record BearingBlockSpec {
+ Width: Length
+ Height: Length
+ Depth: Length
+ BoreDiameter: Length
+ BoreRadius: Length
+ BoreTolerancePlus: Length
+ BoreToleranceMinus: Length
+ Material: String
+ PartNumber: String
+ Revision: Version
+ Company: String
+ Author: String
+ Description: String
+ }
+
+ Template < Spec: BearingBlockSpec >
+ Struct BearingBlock: BearingBlockConcept {
+ Require PositiveDimensions => Spec.Width > 0mm && Spec.Height > 0mm && Spec.Depth > 0mm
+ Require ValidBore => Spec.BoreDiameter > 0mm && Spec.BoreDiameter < Spec.Width && Spec.BoreDiameter < Spec.Height
+ Require ValidTolerance => Spec.BoreTolerancePlus >= 0mm && Spec.BoreToleranceMinus >= 0mm
+
+ Concept Struct Design: BearingBlockConcept {
+ Bounds: Box3 { Size: [Spec.Width, Spec.Height, Spec.Depth] }
+ TopPlane: Bounds.Face(+Z)
+ BoreCenters: Grid {
+ Within: Bounds.Face(+Z).Inset(Spec.BoreRadius)
+ Columns: 1
+ Rows: 1
+ }
+ BoreDiameter: Spec.BoreDiameter
+ }
+ Box Base { Bounds: Design.Bounds }
+ Modify Base {
+ Hole<Shaft> Bore {
+ On: Base.Top
+ Center: Design.BoreCenters[0]
+ Diameter: Spec.BoreDiameter
+ End: ThroughAll
+ }
+ }
+ Require BoreDiameterConstraint {
+ Actual: Bore.Diameter
+ Expected: Spec.BoreDiameter
+ Tolerance: PlusMinus(Spec.BoreTolerancePlus, Spec.BoreToleranceMinus)
+ }
+ Expose {
+ Bounds: Design.Bounds
+ TopPlane: Base.Top
+ BoreCenters: Design.BoreCenters
+ BoreDiameter: Design.BoreDiameter
+ }
+ }
+}
diff --git a/tools/Aetheris.Forge.M1Evidence/Aetheris.Forge.M1Evidence.csproj b/tools/Aetheris.Forge.M1Evidence/Aetheris.Forge.M1Evidence.csproj
index b6b9658a..786511c9 100644
--- a/tools/Aetheris.Forge.M1Evidence/Aetheris.Forge.M1Evidence.csproj
+++ b/tools/Aetheris.Forge.M1Evidence/Aetheris.Forge.M1Evidence.csproj
@@ -6,7 +6,7 @@
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
- <ProjectReference Include="..\..\Aetheris.Forge.Sdk\Aetheris.Forge.Sdk.csproj" />
+ <ProjectReference Include="..\..\Aetheris.Forge.Host\Aetheris.Forge.Host.csproj" />
<ProjectReference Include="..\..\Aetheris.Forge.SampleExtension\Aetheris.Forge.SampleExtension.csproj" />
<ProjectReference Include="..\..\Aetheris.Forge.SampleExtension.Bindings\Aetheris.Forge.SampleExtension.Bindings.csproj" />
<ProjectReference Include="..\..\Aetheris.Forge.Testing\Aetheris.Forge.Testing.csproj" />
diff --git a/tools/Aetheris.Forge.M1Evidence/Program.cs b/tools/Aetheris.Forge.M1Evidence/Program.cs
index 25a16b95..bd443c85 100644
--- a/tools/Aetheris.Forge.M1Evidence/Program.cs
+++ b/tools/Aetheris.Forge.M1Evidence/Program.cs
@@ -1,7 +1,7 @@
using System.Text.Json;
using System.Text.Json.Serialization;
using Aetheris.Forge.Extensions;
-using Aetheris.Forge.Sdk;
+using Aetheris.Forge.Host;
using Aetheris.Forge.Testing;
using MyCompany.SecretGeometry;
using MyCompany.SecretGeometry.Generated;