Share GDSII reader logic and simplify review output

Share record framing, name decoding, payload validation, array reference
decoding, and Arrow cell-header parsing. Accept trailing NUL padding in
names and retain located diagnostics for malformed records.

Summarize text diffs by cell, layer, and reference target. Show comparison
and omission counts before detail. Compact canonical dumps while
preserving exact fields and duplicate counts for Git textconv. Simplify
hierarchy output and retain per-object evidence in JSON.
This commit is contained in:
Jan Petykiewicz 2026-11-17 21:49:26 -08:00
commit 15e8a3b7b5

View file

@ -28,10 +28,15 @@ pheon hierarchy chip.gds --format ascii --depth 4
pheon hierarchy chip.gds --format mermaid --top CHIP
```
`dump` shows a normalized layout description. Add `--records` to inspect raw
records, including timestamps. `hierarchy` shows cell references without
expanding array placements. Shared cells are marked rather than repeated
indefinitely. Mermaid output is diagram source for a Mermaid renderer.
`dump` lists objects by cell. A prefix such as `3x` counts copies of the same
normalized object within a cell. Coordinates are in database units. Rectangles
show two corners, and longer vertex lists wrap across lines. References show
the target and any array dimensions before the coordinates. Add `--records`
to inspect the original record sequence, including timestamps.
`hierarchy` shows direct placement counts on references. Shared cells are
marked where their contents appear earlier in the tree. Mermaid output is
diagram source for a Mermaid renderer.
## Compare revisions
@ -41,10 +46,13 @@ pheon diff before.gds after.gds --hierarchy ascii --max-changes 20
pheon diff before.gds after.gds --format json > report.json
```
Text reports group changes by cell. A `-` line shows an object from the old file
and a `+` line shows one from the new file. A `~` line explains a likely
replacement when Pheon can pair the two uniquely. Request a hierarchy view to
see which parent cells are affected.
Text reports start with the result and group changes by cell. Added and removed
cell headings give the object count within the comparison scope. Each layer
lists counts of rectangles, polygons, and boxes changed, moved, added, or removed.
Added or removed cells also count references by target.
Other objects use `-` for removals, `+` for additions, and `~` for likely
replacements. Use `--format json` for details of individual objects and
`--hierarchy` to see which parent cells are affected.
| Exit code | Meaning |
| --- | --- |
@ -86,8 +94,10 @@ pheon diff before.gds after.gds --hierarchy mermaid --depth 4
`--show-cell` and `--show-layer` filter displayed changes without changing the
comparison, totals, or exit status. A layer display filter hides references
without a numeric layer. `--max-changes N` limits displayed object occurrences;
JSON includes all changed objects unless this limit is explicit.
without a numeric layer. `--max-changes N` limits displayed object occurrences.
A paired replacement uses two occurrences. The text report counts omissions
from filters and limits before listing cell changes. JSON includes all changed
objects unless the limit is explicit.
The diff hierarchy marks directly changed cells, affected ancestors, and
unchanged targets of modified references. It includes references from both