Next Gen STEP AP242 Native-ish BREP Geometric Modeling Kernel
Add ranked analyze map evidence bundles
Yuechen Li9c505b4f7069
diff --git a/Aetheris.CLI.Tests/CliBaselineTests.cs b/Aetheris.CLI.Tests/CliBaselineTests.csindex 53c40c97..18b5113c 100644--- a/Aetheris.CLI.Tests/CliBaselineTests.cs+++ b/Aetheris.CLI.Tests/CliBaselineTests.cs@@ -514,6 +514,41 @@ public sealed class CliBaselineTestsAssert.True(grid[0][0].TryGetProperty("entrySurfaceType", out _));}+ [Fact]+ public void Analyze_Map_RankedProbes_Emits_EvidenceBundle_And_SectionCommands()+ {+ var stepPath = ExportPrimitiveToTempStep(BrepPrimitives.CreateCylinder(4d, 10d).Value, "cli-map-a6-cylinder");+ using var doc = RunAnalyzeSixViewMap(stepPath, "8x8", "--rank-probes", "--evidence-bundle");+ var root = doc.RootElement;++ var ranked = root.GetProperty("rankedProbes");+ Assert.True(ranked.GetArrayLength() > 0);+ var first = ranked[0];+ Assert.True(first.GetProperty("score").GetDouble() > 0d);+ Assert.Contains("analytic provenance", first.GetProperty("reasons").EnumerateArray().Select(r => r.GetString()));+ Assert.Contains(first.GetProperty("recommendedActions").EnumerateArray(), a => a.GetProperty("kind").GetString() == "pointProbe");+ Assert.Contains(first.GetProperty("recommendedActions").EnumerateArray(), a => a.GetProperty("kind").GetString() == "sectionProbe" && a.GetProperty("command").GetString()!.Contains("analyze section", StringComparison.Ordinal));++ var bundle = root.GetProperty("evidenceBundle");+ Assert.Equal(6, bundle.GetProperty("coarseMap").GetProperty("views").GetInt32());+ Assert.True(bundle.GetProperty("rankedQuestions").GetArrayLength() > 0);+ Assert.True(bundle.GetProperty("suggestedActions").GetArrayLength() > 0);+ }++ [Fact]+ public void Analyze_Map_PointProbe_Emits_CompactSummary_And_Retains_Hits()+ {+ var stepPath = ExportPrimitiveToTempStep(BrepPrimitives.CreateBox(10d, 6d, 4d).Value, "cli-map-a6-point-summary");+ using var doc = RunAnalyzeRayMap(stepPath, "--plane", "xy", "--direction", "-z", "--point", "0,0");+ var root = doc.RootElement;+ var summary = root.GetProperty("pointSummary");+ Assert.True(summary.GetProperty("hitCount").GetInt32() >= 2);+ Assert.Equal("plane", summary.GetProperty("firstHit").GetProperty("family").GetString());+ Assert.Equal("plane", summary.GetProperty("lastHit").GetProperty("family").GetString());+ Assert.True(summary.GetProperty("familySequence").GetArrayLength() >= 1);+ Assert.True(root.GetProperty("hits").GetArrayLength() >= 2);+ }+[Fact]public void Analyze_Map_RayProbe_BoxTop_Returns_Llm_Grid_Samples(){@@ -1542,11 +1577,11 @@ public sealed class CliBaselineTestsreturn JsonDocument.Parse(stdout.ToString());}- private static JsonDocument RunAnalyzeSixViewMap(string stepPath, string resolution)+ private static JsonDocument RunAnalyzeSixViewMap(string stepPath, string resolution, params string[] extraArgs){var stdout = new StringWriter();var stderr = new StringWriter();- var exitCode = Aetheris.CLI.CliRunner.Run(["analyze", "map", stepPath, "--views", "six", "--resolution", resolution, "--llm", "--json"], stdout, stderr);+ var exitCode = Aetheris.CLI.CliRunner.Run(["analyze", "map", stepPath, "--views", "six", "--resolution", resolution, "--llm", .. extraArgs, "--json"], stdout, stderr);Assert.Equal(0, exitCode);Assert.True(string.IsNullOrWhiteSpace(stderr.ToString()), stderr.ToString());return JsonDocument.Parse(stdout.ToString());diff --git a/Aetheris.CLI/CliRunner.cs b/Aetheris.CLI/CliRunner.csindex 159a9647..3f5bf85c 100644--- a/Aetheris.CLI/CliRunner.cs+++ b/Aetheris.CLI/CliRunner.cs@@ -109,7 +109,7 @@ public static class CliRunnerprivate const string TopLevelUsage = "Usage: aetheris <build|analyze|trace|canon|asm|experimental> <path> [options]";private const string BuildUsage = "Usage: aetheris build <file.firmament> [--out <path>] [--json]";private const string AnalyzeUsage = "Usage: aetheris analyze <file.step> [--face <id>] [--edge <id>] [--vertex <id>] [--json]";- private const string AnalyzeMapUsage = "Usage: aetheris analyze map <file.step> (--plane <xy|xz|yz> --direction <+x|-x|+y|-y|+z|-z> | --views six --llm) --resolution <NxM> [--point <u,v>] --json";+ private const string AnalyzeMapUsage = "Usage: aetheris analyze map <file.step> (--plane <xy|xz|yz> --direction <+x|-x|+y|-y|+z|-z> | --views six --llm) --resolution <NxM> [--point <u,v>] [--rank-probes|--evidence-bundle] --json";private const string AnalyzeSectionUsage = "Usage: aetheris analyze section <file.step> (--xy|--xz|--yz) --offset <value> --json";private const string AnalyzeVolumeUsage = "Usage: aetheris analyze volume <file.step> [--approximate --resolution <N>] [--json]";private const string AnalyzeCompareUsage = "Usage: aetheris analyze compare <reference.step> <candidate.step> [--approximate-volume --resolution <N>] [--json]";@@ -1766,6 +1766,8 @@ public static class CliRunner(double U, double V)? point = null;var json = false;var llm = false;+ var rankProbes = false;+ var evidenceBundle = false;for (var i = 1; i < args.Length; i++){@@ -1827,6 +1829,15 @@ public static class CliRunnercase "--summary":llm = true;break;+ case "--rank-probes":+ rankProbes = true;+ llm = true;+ break;+ case "--evidence-bundle":+ evidenceBundle = true;+ rankProbes = true;+ llm = true;+ break;case "--direction":stderr.WriteLine("Analyze map option --direction requires +x, -x, +y, -y, +z, or -z.");stderr.WriteLine(AnalyzeMapUsage);@@ -1917,7 +1928,7 @@ public static class CliRunnertry{map = sixViewMode- ? StepAnalyzer.AnalyzeSixViewMapSummary(stepPath, cols.Value, rows.Value)+ ? (rankProbes || evidenceBundle ? StepAnalyzer.AnalyzeSixViewMapEvidenceBundle(stepPath, cols.Value, rows.Value) : StepAnalyzer.AnalyzeSixViewMapSummary(stepPath, cols.Value, rows.Value)): legacyViewMode? StepAnalyzer.AnalyzeMap(stepPath, view.GetValueOrDefault(), rows.Value, cols.Value): StepAnalyzer.AnalyzeRayMap(stepPath, plane!, direction!, cols.Value, rows.Value, point);@@ -2296,7 +2307,7 @@ public static class CliRunnerstdout.WriteLine();stdout.WriteLine("Example:");stdout.WriteLine(" aetheris analyze map part.step --top --rows 48 --cols 64 --json");- stdout.WriteLine(" aetheris analyze map part.step --views six --resolution 32x32 --llm --json");+ stdout.WriteLine(" aetheris analyze map part.step --views six --resolution 16x16 --llm --rank-probes --json");}private static void WriteAnalyzeSectionHelp(TextWriter stdout)diff --git a/Aetheris.CLI/StepAnalysisModels.cs b/Aetheris.CLI/StepAnalysisModels.csindex c932184d..634a08f2 100644--- a/Aetheris.CLI/StepAnalysisModels.cs+++ b/Aetheris.CLI/StepAnalysisModels.cs@@ -123,8 +123,17 @@ public sealed record RayMapBounds(double[] U, double[] V);public sealed record RayMapHit(double T, Point3D Position, int? FaceIndex, string? SurfaceFamily, Vector3D? Normal, string IntersectionMode, string Confidence, IReadOnlyList<string> Diagnostics);public sealed record RayMapSample(int I, int J, double U, double V, bool Hit, RayMapHit? FirstHit, RayMapHit? LastHit, int HitCount, IReadOnlyList<RayMapHit> Hits, IReadOnlyDictionary<string, int> IntersectionModes);public sealed record RayMapSummary(double HitCoverage, double[]? HeightRange, IReadOnlyDictionary<string, int> SurfaceFamiliesHit, int AnalyticHitCount, int CirHitCount, int TessellatedFallbackHitCount, int UnsupportedSampleCount);-public sealed record RayMapResult(string Mode, string Plane, string Direction, int[]? Resolution, double[]? Point, RayMapBounds Bounds, IReadOnlyList<RayMapSample> Samples, int HitCount, IReadOnlyList<RayMapHit>? Hits, RayMapSummary Summary, string IntersectionMode, string BackendPolicy, IReadOnlyList<string> Diagnostics);-public sealed record SixViewMapResult(string Mode, string MapVersion, int[] Resolution, IReadOnlyList<SixViewMapView> Views, IReadOnlyList<SuggestedMapProbe> SuggestedProbes, IReadOnlyList<string> Diagnostics);+public sealed record RayMapResult(string Mode, string Plane, string Direction, int[]? Resolution, double[]? Point, RayMapBounds Bounds, IReadOnlyList<RayMapSample> Samples, int HitCount, IReadOnlyList<RayMapHit>? Hits, RayMapSummary Summary, string IntersectionMode, string BackendPolicy, IReadOnlyList<string> Diagnostics)+{+ public CompactPointProbeSummary? PointSummary { get; init; }+}+public sealed record CompactPointProbeSummary(int HitCount, CompactHitSummary? FirstHit, CompactHitSummary? LastHit, IReadOnlyList<string> FamilySequence, IReadOnlyDictionary<string, int> BackendModes, double[]? CoordinateRangeAlongRay, IReadOnlyList<string> Diagnostics);+public sealed record CompactHitSummary(string? Family, Point3D Position, int? FaceId, string IntersectionMode);+public sealed record SixViewMapResult(string Mode, string MapVersion, int[] Resolution, IReadOnlyList<SixViewMapView> Views, IReadOnlyList<SuggestedMapProbe> SuggestedProbes, IReadOnlyList<string> Diagnostics)+{+ public IReadOnlyList<RankedMapProbe> RankedProbes { get; init; } = Array.Empty<RankedMapProbe>();+ public EvidenceBundle? EvidenceBundle { get; init; }+}public sealed record SixViewMapView(string Name, string Plane, string Direction, SixViewMapSummary Summary, CompactGrid? CompactGrid, SixViewMapComponents Components, IReadOnlyList<SuggestedMapProbe> SuggestedProbes, IReadOnlyList<string> MeasuredSummary);public sealed record SixViewMapSummary(int SampleCount, int HitCount, double HitCoverage, double[]? HeightRange, IReadOnlyList<DominantBand> DominantBands, IReadOnlyDictionary<string, int> SurfaceFamiliesHit, IReadOnlyDictionary<string, int> BackendCounts, double FallbackRatio);public sealed record DominantBand(double? Value, int SampleCount, double Coverage, string? Meaning, bool MostlyFallback);@@ -133,6 +142,11 @@ public sealed record SixViewMapComponents(IReadOnlyList<MapComponent> NoHit, IRepublic sealed record MapComponent(string ComponentId, string Kind, string View, int CellCount, double Coverage, bool TouchesBorder, CellBoundingBox BboxCells, double[] CentroidCell, double[] CentroidUv, string? ClassificationHint, string Confidence, string? Band, double? RepresentativeValue, string? SurfaceFamily, string? BackendModeDominance);public sealed record CellBoundingBox(int MinI, int MinJ, int MaxI, int MaxJ);public sealed record SuggestedMapProbe(string ProbeId, string View, string Plane, string Direction, double[] Point, string Reason, string Command, string? SourceComponentId);+public sealed record EvidenceAction(string Kind, string? View, string Command, string Reason, object? Bounds = null, int[]? Resolution = null);+public sealed record RankedMapProbe(int Rank, double Score, double NormalizedScore, string Kind, string View, string ComponentId, string? ClassificationHint, IReadOnlyList<string> Reasons, IReadOnlyList<string> EvidenceTerms, double Uncertainty, string RecommendedNextAction, IReadOnlyList<EvidenceAction> RecommendedActions);+public sealed record EvidenceBundle(string Source, EvidenceBundleCoarseMap CoarseMap, IReadOnlyList<RankedMapProbe> RankedQuestions, IReadOnlyList<EvidenceAction> SuggestedActions, IReadOnlyList<object> ExecutedEvidence, EvidenceBundleLimits Limits, IReadOnlyList<string> Notes);+public sealed record EvidenceBundleCoarseMap(int[] Resolution, int Views, bool SummaryOnly);+public sealed record EvidenceBundleLimits(int MaxRankedItems, int MaxExecutedProbes);public enum SectionPlaneFamily{diff --git a/Aetheris.CLI/StepAnalyzer.cs b/Aetheris.CLI/StepAnalyzer.csindex 6557df25..943c1d02 100644--- a/Aetheris.CLI/StepAnalyzer.cs+++ b/Aetheris.CLI/StepAnalyzer.cs@@ -940,6 +940,24 @@ public sealed record VolumeAnalysisResult(return AnalyzeImportedBodySixViewMapSummary(body, fullPath, cols, rows);}+ public static SixViewMapResult AnalyzeSixViewMapEvidenceBundle(string stepPath, int cols, int rows)+ {+ var result = AnalyzeSixViewMapSummary(stepPath, cols, rows);+ var ranked = RankSixViewProbes(result.Views, stepPath, cols, rows, 30).ToArray();+ return result with+ {+ RankedProbes = ranked,+ EvidenceBundle = new EvidenceBundle(+ stepPath,+ new EvidenceBundleCoarseMap([cols, rows], result.Views.Count, true),+ ranked,+ ranked.SelectMany(r => r.RecommendedActions).Take(90).ToArray(),+ Array.Empty<object>(),+ new EvidenceBundleLimits(30, 0),+ ["A6 does not execute follow-up probes automatically; commands are bounded local evidence requests.", "Local map bounds are recommendations because analyze map does not yet accept explicit --bounds."])+ };+ }+public static SixViewMapResult AnalyzeImportedBodySixViewMapSummary(BrepBody body, string stepPath, int cols, int rows){if (rows <= 0 || cols <= 0) throw new InvalidOperationException("Map resolution must be positive.");@@ -966,7 +984,8 @@ public sealed record VolumeAnalysisResult(views.Add(BuildSixViewSummary(definition.Name, map, cols, rows, stepPath));}- return new SixViewMapResult("six-view-summary", "analyze-map-v1", [cols, rows], views, views.SelectMany(v => v.SuggestedProbes).Take(30).ToArray(), diagnostics.ToArray());+ var suggested = views.SelectMany(v => v.SuggestedProbes).Take(30).ToArray();+ return new SixViewMapResult("six-view-summary", "analyze-map-v1", [cols, rows], views, suggested, diagnostics.ToArray());}public static RayMapResult AnalyzeImportedBodyRayMap(BrepBody body, string stepPath, string plane, string direction, int cols, int rows, (double U, double V)? point = null)@@ -1060,7 +1079,8 @@ public sealed record VolumeAnalysisResult(var mode = point.HasValue ? "point" : "grid";var pointArray = point.HasValue ? new[] { point.Value.U, point.Value.V } : null;var resultMode = tessellatedFallbackHitCount > 0 ? "analytic-first-with-tessellated-fallback" : "analytic";- return new RayMapResult(mode, plane.ToLowerInvariant(), direction.ToLowerInvariant(), point.HasValue ? null : [cols, rows], pointArray, bounds, samples, samples.Sum(s => s.HitCount), point.HasValue ? samples.Single().Hits : null, summary, resultMode, "analytic-cir-tessellated-fallback", diagnostics);+ var result = new RayMapResult(mode, plane.ToLowerInvariant(), direction.ToLowerInvariant(), point.HasValue ? null : [cols, rows], pointArray, bounds, samples, samples.Sum(s => s.HitCount), point.HasValue ? samples.Single().Hits : null, summary, resultMode, "analytic-cir-tessellated-fallback", diagnostics);+ return point.HasValue ? result with { PointSummary = BuildCompactPointProbeSummary(samples.Single(), direction) } : result;}private static SixViewMapView BuildSixViewSummary(string name, RayMapResult map, int cols, int rows, string stepPath)@@ -1302,6 +1322,60 @@ public sealed record VolumeAnalysisResult(return new SuggestedMapProbe(id, view, plane, direction, component.CentroidUv, reason, command, component.ComponentId);}++ private static CompactPointProbeSummary BuildCompactPointProbeSummary(RayMapSample sample, string direction)+ {+ static CompactHitSummary? Hit(RayMapHit? h) => h is null ? null : new CompactHitSummary(h.SurfaceFamily, h.Position, h.FaceIndex, h.IntersectionMode);+ var sequence = sample.Hits.Select(h => h.SurfaceFamily ?? "unknown").ToArray();+ if (sequence.Length > 8)+ {+ sequence = sequence.Take(4).Concat(["...x" + (sequence.Length - 8).ToString(System.Globalization.CultureInfo.InvariantCulture)]).Concat(sequence.TakeLast(4)).ToArray();+ }++ var range = sample.Hits.Count == 0 ? null : new[] { sample.Hits.Min(h => h.T), sample.Hits.Max(h => h.T) };+ return new CompactPointProbeSummary(sample.HitCount, Hit(sample.FirstHit), Hit(sample.LastHit), sequence, sample.IntersectionModes, range, sample.Hits.SelectMany(h => h.Diagnostics).Distinct(StringComparer.Ordinal).Take(8).ToArray());+ }++ private static IReadOnlyList<RankedMapProbe> RankSixViewProbes(IReadOnlyList<SixViewMapView> views, string stepPath, int cols, int rows, int limit)+ {+ var candidates = views.SelectMany(v => v.Components.NoHit.Concat(v.Components.SurfaceFamilies).Concat(v.Components.HeightBands).Concat(v.Components.Fallback).Select(c => (View: v, Component: c)))+ .Select(x => ScoreComponent(x.View, x.Component, stepPath, cols, rows))+ .OrderByDescending(x => x.Score).ThenBy(x => x.View).ThenBy(x => x.ComponentId, StringComparer.Ordinal)+ .Take(limit).ToArray();+ var max = candidates.Length == 0 ? 1d : Math.Max(1e-9d, candidates.Max(c => c.Score));+ return candidates.Select((c, i) => c with { Rank = i + 1, NormalizedScore = Math.Round(c.Score / max, 4) }).ToArray();+ }++ private static RankedMapProbe ScoreComponent(SixViewMapView view, MapComponent c, string stepPath, int cols, int rows)+ {+ var reasons = new List<string>(); var terms = new List<string>(); var score = 0.05d;+ if (c.Kind == "no-hit" && !c.TouchesBorder) { score += 0.45; reasons.Add("interior no-hit component"); terms.Add("interior-no-hit"); }+ if (c.Kind == "no-hit" && c.TouchesBorder) { score -= 0.10; reasons.Add("border-touching exterior/silhouette candidate"); terms.Add("border-no-hit"); }+ if (c.SurfaceFamily is "cylinder" or "cone" or "torus") { score += 0.35; reasons.Add($"{c.SurfaceFamily} surface-family cluster"); terms.Add("curved-analytic-family"); }+ if (c.SurfaceFamily is "sphere") { score += 0.20; reasons.Add("sphere surface-family cluster"); terms.Add("curved-analytic-family"); }+ if (c.BackendModeDominance == "analytic") { score += 0.12; reasons.Add("analytic provenance"); terms.Add("analytic-provenance"); }+ if (c.BackendModeDominance == "tessellated-fallback") { score += 0.20; reasons.Add("fallback component needs truth-checking"); terms.Add("fallback-uncertain"); }+ if (c.Kind == "height-band" && c.Coverage < 0.20) { score += 0.18; reasons.Add("small isolated height-band component"); terms.Add("local-height-band"); }+ if (!c.TouchesBorder) { score += 0.10; reasons.Add("interior to view bounds"); terms.Add("interior-locality"); }+ var centerDistance = Math.Abs(c.CentroidCell[0] - (cols - 1) / 2d) / Math.Max(1, cols) + Math.Abs(c.CentroidCell[1] - (rows - 1) / 2d) / Math.Max(1, rows);+ if (centerDistance < 0.25) { score += 0.08; reasons.Add("central region"); terms.Add("centrality"); }+ score += Math.Min(0.12, c.CellCount / 64d);+ var uncertainty = c.BackendModeDominance == "tessellated-fallback" ? 0.55 : c.Confidence == "low" ? 0.35 : 0.2;+ var classification = c.ClassificationHint ?? (c.SurfaceFamily is null ? c.Kind : c.SurfaceFamily + "-feature-candidate");+ var actions = BuildEvidenceActions(view, c, stepPath, classification).ToArray();+ return new RankedMapProbe(0, Math.Round(Math.Clamp(score, 0d, 1d), 4), 0, "componentProbe", view.Name, c.ComponentId, classification, reasons.Count == 0 ? ["bounded component worth sampling"] : reasons, terms, uncertainty, actions.FirstOrDefault()?.Kind ?? "pointProbe", actions);+ }++ private static IEnumerable<EvidenceAction> BuildEvidenceActions(SixViewMapView view, MapComponent c, string stepPath, string reason)+ {+ var pointText = $"{c.CentroidUv[0]:0.####},{c.CentroidUv[1]:0.####}";+ yield return new EvidenceAction("pointProbe", view.Name, $"aetheris analyze map {stepPath} --plane {view.Plane} --direction {view.Direction} --point {pointText} --json", reason);+ var axes = view.Plane switch { "xy" => ("--yz", "--xz"), "xz" => ("--yz", "--xy"), "yz" => ("--xz", "--xy"), _ => ("--xy", "--xz") };+ yield return new EvidenceAction("sectionProbe", view.Name, $"aetheris analyze section {stepPath} {axes.Item1} --offset {c.CentroidUv[0]:0.####} --json", "Section through component centroid along first view axis.");+ yield return new EvidenceAction("sectionProbe", view.Name, $"aetheris analyze section {stepPath} {axes.Item2} --offset {c.CentroidUv[1]:0.####} --json", "Section through component centroid along second view axis.");+ yield return new EvidenceAction("localMap", view.Name, $"suggestedLocalMapUnsupported: analyze map does not yet accept explicit local bounds", "Refine around ranked component when --bounds is added.", new { u = new[] { c.CentroidUv[0] - 1d, c.CentroidUv[0] + 1d }, v = new[] { c.CentroidUv[1] - 1d, c.CentroidUv[1] + 1d } }, [16, 16]);+ }+private static IReadOnlyList<string> BuildMeasuredSummary(string name, RayMapResult map, SixViewMapSummary summary, SixViewMapComponents? components = null){var lines = new List<string>diff --git a/docs/implementation/analyze-map-a5-components-and-probes.md b/docs/implementation/analyze-map-a5-components-and-probes.mdindex f1a8f485..a77dffd0 100644--- a/docs/implementation/analyze-map-a5-components-and-probes.md+++ b/docs/implementation/analyze-map-a5-components-and-probes.md@@ -132,3 +132,7 @@ FTC-09 dogfooding showed that broad six-view facts were useful but not actionabl- Face-id grids and connected face-region summaries.- View-pair correlation to relate a top-view island to front/side evidence.- Conservative hole/slot candidate hints that remain measured and explicitly non-semantic.++## A6 follow-up++ANALYZE-MAP-A6 builds on these components by ranking them for LLM CAD reasoning, adding section-probe suggestions, evidence-bundle output, and compact point-probe summaries. See `docs/implementation/analyze-map-a6-ranked-probes-and-section-bridge.md`.diff --git a/docs/implementation/analyze-map-a6-ranked-probes-and-section-bridge.md b/docs/implementation/analyze-map-a6-ranked-probes-and-section-bridge.mdnew file mode 100644index 00000000..160e4504--- /dev/null+++ b/docs/implementation/analyze-map-a6-ranked-probes-and-section-bridge.md@@ -0,0 +1,85 @@+# ANALYZE-MAP-A6 ranked probes and section bridge++A6 keeps `aetheris analyze map` on the local-measurement path: start with a coarse six-view map, rank bounded component questions, and emit point-probe, local-map, and section-slice follow-ups instead of brute-forcing larger global grids.++## Why not full maps++CTC-01 dogfooding showed 16x16 six-view maps are useful but already noticeable in tight LLM loops, while 32x32 global maps can be too slow. A6 therefore preserves coarse maps and asks smaller local questions around suspicious components.++## Command shape++```bash+aetheris analyze map part.step --views six --resolution 16x16 --llm --rank-probes --json+aetheris analyze map part.step --views six --resolution 16x16 --llm --evidence-bundle --json+```++`--evidence-bundle` implies ranked probes. Existing detailed map output remains present.++## JudgmentEngine integration decision++The existing `JudgmentEngine<TContext>` is a single-winner deterministic chooser. A6 needs a ranked list of many useful local questions, so the implementation uses a small deterministic scorer that is JudgmentEngine-compatible in shape: explicit admissible candidates, scores, evidence terms, tie-breaking, and rejection-by-low-score potential. A future adapter can move this into a multi-selection JudgmentEngine API without changing the JSON schema.++## Scoring factors++Higher scores are assigned to:++- interior no-hit components;+- cylinder, cone, torus, and sphere surface-family clusters;+- analytic provenance;+- fallback components needing truth-checking;+- small isolated height-band components;+- central/non-border regions;+- moderate component size.++Lower scores are assigned to large border-touching no-hit regions because they are often exterior silhouette gaps.++Each ranked probe includes score, normalized score, reasons, evidence terms, uncertainty, classification hint, and recommended actions.++## Map/section bridge++For every ranked component, A6 emits:++- a compact point-probe command using the component centroid;+- two `aetheris analyze section` commands through the centroid, mapped from the current view plane to supported `--xy`, `--xz`, or `--yz` section syntax;+- a local map refinement recommendation.++Follow-up evidence is not executed automatically in A6. Local map commands are marked unsupported because `analyze map` does not yet accept explicit bounds.++## Evidence bundle schema++The `evidenceBundle` object contains:++- `source`;+- `coarseMap` with resolution, view count, and summary-only flag;+- `rankedQuestions` mirroring `rankedProbes`;+- flattened `suggestedActions`;+- empty `executedEvidence` for A6;+- `limits` with max ranked items and max executed probes;+- notes about non-execution and bounds limitations.++## Compact point-probe summary++Point-probe JSON now includes `pointSummary` with:++- hit count;+- first/last hit family, position, face id, and backend mode;+- compressed family sequence;+- backend mode counts;+- coordinate range along the ray;+- compact diagnostics.++The full `hits` array is retained.++## Limitations++- No feature reconstruction or hole/slot assertions are made.+- No automatic section or point-probe execution is performed by the evidence bundle.+- Local map windows are recommendations until explicit bounds are supported.+- Cross-view correlation and repeated/symmetric feature grouping remain future work.++## Next milestone candidates++- Execute local map bounds.+- Adaptive refinement around high-ranked components.+- Cross-view correlation.+- Face/surface-family grids.diff --git a/docs/reports/analyze-map-dogfood-ctc01-a0.md b/docs/reports/analyze-map-dogfood-ctc01-a0.mdindex 3edd62e7..b934ab7a 100644--- a/docs/reports/analyze-map-dogfood-ctc01-a0.md+++ b/docs/reports/analyze-map-dogfood-ctc01-a0.md@@ -226,3 +226,7 @@ Recommended next modeling primitive:**`ANALYZE-MAP-A6 — cross-view component correlation and face/surface-family grids`**This is the best next milestone for CTC-01. The blocker exposed by this dogfood pass is no longer “can rays hit this model?” The blocker is that the LLM receives uncorrelated components. Cross-view correlation plus component-level face/surface-family grids would make the current measured evidence directly usable for semantic decompilation: holes, rounded slots, lobes, boss boundaries, conical features, and symmetry pairs could become testable candidates instead of prose guesses.++## A6 follow-up++ANALYZE-MAP-A6 addresses this report's locality and ranking findings by adding `--rank-probes` / `--evidence-bundle` output, deterministic component utility scores, section bridge commands, local map window recommendations, and compact point-probe summaries. See `docs/implementation/analyze-map-a6-ranked-probes-and-section-bridge.md`.