Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Improve analyze default human-readable output
Yuechen Li847a70c0064e
diff --git a/Aetheris.CLI.Tests/CliBaselineTests.cs b/Aetheris.CLI.Tests/CliBaselineTests.csindex c87bcd84..0b2715ef 100644--- a/Aetheris.CLI.Tests/CliBaselineTests.cs+++ b/Aetheris.CLI.Tests/CliBaselineTests.cs@@ -680,6 +680,25 @@ public sealed class CliBaselineTestsAssert.True(root.TryGetProperty("summary", out _));}+ [Fact]+ public void Analyze_Command_Default_Output_Is_Human_Readable_Summary()+ {+ var stepPath = Path.Combine(RepoRoot, "testdata/firmament/exports/box_basic.step");+ var stdout = new StringWriter();+ var stderr = new StringWriter();++ var exitCode = Aetheris.CLI.CliRunner.Run(["analyze", stepPath], stdout, stderr);++ Assert.Equal(0, exitCode);+ Assert.True(string.IsNullOrWhiteSpace(stderr.ToString()));+ var text = stdout.ToString();+ Assert.Contains("Structural assessment:", text, StringComparison.Ordinal);+ Assert.Contains("Faces:", text, StringComparison.Ordinal);+ Assert.Contains("Edges:", text, StringComparison.Ordinal);+ Assert.Contains("Vertices:", text, StringComparison.Ordinal);+ Assert.DoesNotContain("{\"stepPath\":", text, StringComparison.Ordinal);+ }+[Fact]public void Analyze_Command_MultiRootStep_JsonFailure_IsAssemblyLikeAndMachineFriendly(){@@ -706,6 +725,22 @@ public sealed class CliBaselineTestsAssert.Equal("Importer.AssemblyLike.StepMultiRoot", first.GetProperty("source").GetString());}+ [Fact]+ public void Analyze_Command_MultiRootStep_Default_Output_Has_AssemblyLike_Guidance()+ {+ var stepPath = Path.Combine(RepoRoot, "testdata/step242/OCCT/as1.step");+ var stdout = new StringWriter();+ var stderr = new StringWriter();++ var exitCode = Aetheris.CLI.CliRunner.Run(["analyze", stepPath], stdout, stderr);++ Assert.Equal(1, exitCode);+ Assert.True(string.IsNullOrWhiteSpace(stdout.ToString()));+ var text = stderr.ToString();+ Assert.Contains("assembly-like STEP", text, StringComparison.OrdinalIgnoreCase);+ Assert.Contains("assembly extraction/import workflow", text, StringComparison.OrdinalIgnoreCase);+ }+[Fact]public void Canon_Command_RoundTrips_Supported_Step_Through_Importer_Exporter_Path(){diff --git a/Aetheris.CLI.Tests/CliHelpAndUsageTests.cs b/Aetheris.CLI.Tests/CliHelpAndUsageTests.csindex bd97ab68..1bb8b953 100644--- a/Aetheris.CLI.Tests/CliHelpAndUsageTests.cs+++ b/Aetheris.CLI.Tests/CliHelpAndUsageTests.cs@@ -50,6 +50,20 @@ public sealed class CliHelpAndUsageTestsAssert.Contains("Example", text, StringComparison.Ordinal);}+ [Fact]+ public void Analyze_Help_Explains_Default_Text_And_Json_Mode()+ {+ var stdout = new StringWriter();+ var stderr = new StringWriter();++ var exitCode = Aetheris.CLI.CliRunner.Run(["analyze", "--help"], stdout, stderr);++ Assert.Equal(0, exitCode);+ Assert.True(string.IsNullOrWhiteSpace(stderr.ToString()));+ var text = stdout.ToString();+ Assert.Contains("default output is human-readable text", text, StringComparison.Ordinal);+ }+[Fact]public void Analyze_Map_Missing_Cols_Has_Clear_Diagnostic(){diff --git a/Aetheris.CLI/CliRunner.cs b/Aetheris.CLI/CliRunner.csindex 0f3c14cc..a8078564 100644--- a/Aetheris.CLI/CliRunner.cs+++ b/Aetheris.CLI/CliRunner.cs@@ -495,7 +495,7 @@ public static class CliRunner{if (!json){- stderr.WriteLine(ex.Message);+ WriteAnalyzeFailureText(stderr, stepPath, ex);return 1;}@@ -967,18 +967,19 @@ public static class CliRunnerprivate static void WriteSummaryText(AnalyzeResult analysis, TextWriter stdout){var summary = analysis.Summary;- stdout.WriteLine($"STEP: {analysis.StepPath}");+ stdout.WriteLine($"Input file: {analysis.StepPath}");+ stdout.WriteLine("Success: yes");+ stdout.WriteLine($"Structural assessment: {summary.StructuralAssessment} ({summary.StructuralAssessmentBasis})");+ stdout.WriteLine($"Length unit: {summary.LengthUnit} ({summary.LengthUnitBasis})");stdout.WriteLine($"Bodies: {summary.BodyCount}");stdout.WriteLine($"Shells: {summary.ShellCount}");+ stdout.WriteLine($"Bounding box: {FormatBox(summary.BoundingBox)}");stdout.WriteLine($"Faces: {summary.FaceCount}");stdout.WriteLine($"Edges: {summary.EdgeCount}");stdout.WriteLine($"Vertices: {summary.VertexCount}");- stdout.WriteLine($"BoundingBox: {FormatBox(summary.BoundingBox)}");- stdout.WriteLine($"Structure: {summary.StructuralAssessment} ({summary.StructuralAssessmentBasis})");- stdout.WriteLine($"LengthUnit: {summary.LengthUnit} ({summary.LengthUnitBasis})");- stdout.WriteLine($"FaceIds: min={summary.FaceIds.Min}, max={summary.FaceIds.Max}, count={summary.FaceIds.Count}, contiguous={summary.FaceIds.Contiguous}");- stdout.WriteLine($"EdgeIds: min={summary.EdgeIds.Min}, max={summary.EdgeIds.Max}, count={summary.EdgeIds.Count}, contiguous={summary.EdgeIds.Contiguous}");- stdout.WriteLine($"VertexIds: min={summary.VertexIds.Min}, max={summary.VertexIds.Max}, count={summary.VertexIds.Count}, contiguous={summary.VertexIds.Contiguous}");+ stdout.WriteLine($"Face IDs: min={summary.FaceIds.Min}, max={summary.FaceIds.Max}, count={summary.FaceIds.Count}, contiguous={summary.FaceIds.Contiguous}");+ stdout.WriteLine($"Edge IDs: min={summary.EdgeIds.Min}, max={summary.EdgeIds.Max}, count={summary.EdgeIds.Count}, contiguous={summary.EdgeIds.Contiguous}");+ stdout.WriteLine($"Vertex IDs: min={summary.VertexIds.Min}, max={summary.VertexIds.Max}, count={summary.VertexIds.Count}, contiguous={summary.VertexIds.Contiguous}");stdout.WriteLine("Surface Families:");foreach (var family in summary.SurfaceFamilies){@@ -1010,6 +1011,41 @@ public static class CliRunner}}+ private static void WriteAnalyzeFailureText(TextWriter stderr, string stepPath, Exception exception)+ {+ var fullPath = Path.GetFullPath(stepPath);+ if (exception is not StepAnalysisImportException importFailure)+ {+ stderr.WriteLine($"Analyze failed for: {fullPath}");+ stderr.WriteLine($"Reason: {exception.Message}");+ return;+ }++ var multiRootDiagnostic = importFailure.Diagnostics.FirstOrDefault(d => string.Equals(d.Source, "Importer.AssemblyLike.StepMultiRoot", StringComparison.Ordinal));+ if (multiRootDiagnostic is not null)+ {+ var rigidRootCount = CountManifoldSolidRoots(multiRootDiagnostic.Message);+ stderr.WriteLine($"Input file: {fullPath}");+ stderr.WriteLine("Success: no");+ stderr.WriteLine("Classification: assembly-like STEP (multi-root manifold solids).");+ if (rigidRootCount.HasValue)+ {+ stderr.WriteLine($"Detected manifold-solid roots: {rigidRootCount.Value}");+ }++ stderr.WriteLine("Guidance: Use the assembly extraction/import workflow for this STEP input.");+ stderr.WriteLine($"Reason: {multiRootDiagnostic.Message}");+ return;+ }++ stderr.WriteLine($"Analyze failed for: {fullPath}");+ stderr.WriteLine("Reason: STEP import failure.");+ foreach (var diagnostic in importFailure.Diagnostics)+ {+ stderr.WriteLine($"- [{diagnostic.Severity}] {diagnostic.Source}: {diagnostic.Message}");+ }+ }+private static int UnknownCommand(string command, TextWriter stderr){stderr.WriteLine($"Unknown command '{command}'. Expected one of: build, analyze, canon, asm.");@@ -1049,6 +1085,7 @@ public static class CliRunnerstdout.WriteLine();stdout.WriteLine("Examples:");stdout.WriteLine(" aetheris build model.firmament --out model.step");+ stdout.WriteLine(" aetheris analyze model.step");stdout.WriteLine(" aetheris analyze model.step --json");stdout.WriteLine(" aetheris canon input.step --out canonical.step --json");stdout.WriteLine(" aetheris asm exec assembly.firmasm --json");@@ -1086,7 +1123,7 @@ public static class CliRunnerstdout.WriteLine(" --face <id> Inspect one face.");stdout.WriteLine(" --edge <id> Inspect one edge.");stdout.WriteLine(" --vertex <id> Inspect one vertex.");- stdout.WriteLine(" --json Emit machine-readable JSON.");+ stdout.WriteLine(" --json Emit machine-readable JSON (default output is human-readable text).");stdout.WriteLine(" -h, --help Show this help.");stdout.WriteLine();stdout.WriteLine("Rules:");@@ -1096,7 +1133,9 @@ public static class CliRunnerstdout.WriteLine(" - Assembly-like multi-root STEP is rejected here with a route hint to assembly extraction/import.");stdout.WriteLine();stdout.WriteLine("Examples:");+ stdout.WriteLine(" aetheris analyze part.step");stdout.WriteLine(" aetheris analyze part.step --json");+ stdout.WriteLine(" aetheris analyze part.step --face 12");stdout.WriteLine(" aetheris analyze part.step --face 12 --json");stdout.WriteLine(" aetheris analyze map part.step --right --rows 20 --cols 30 --json");stdout.WriteLine(" aetheris analyze section part.step --yz --offset 1.25 --json");