Skip to content

Prepare 0.2.0: use structured hierarchical paths - #41

Merged
xtofalex merged 1 commit into
mainfrom
structured-paths-0.2.0
Nov 19, 2026
Merged

xtofalex merged 1 commit into
mainfrom
structured-paths-0.2.0

Conversation

@xtofalex

Copy link
Copy Markdown
Contributor

Hierarchical path strings can resolve to the wrong object when exact names contain dots, brackets or other punctuation. Replace them throughout the API and MCP tools with lists of exact names and a separate bit field. For example, ["a.b"] selects one instance while ["a", "b"] selects a different occurrence.

This is a breaking client change: string paths are rejected without a compatibility parser. Search patterns use per-element globs with ** for recursive descent. Returned descriptors round-trip through resolve; connectivity, cone groups, intent, hierarchy, source and schematic tools use the structured contract, including typed nested export and annotation schemas.

Prepare version 0.2.0, update runtime/MCP Registry metadata, convert examples and tests, and add release notes, a changelog and migration documentation. No tag or package publication is included.

Validation:

  • Full suite: 207 passed, 0 failed, 0 skipped, including all three CVA6 regressions against a freshly saved and reloaded najaeda 0.7.35 snapshot; the shared cache was preserved.
  • New coverage includes escaped Verilog and Yosys names, dotted VHDL generate labels, ambiguous splits, scalar bracket names versus bus bits, spaces and punctuation, anonymous-address collisions, round trips, indexed errors and MCP schemas.
  • UART and gate-level walkthroughs pass; git diff --check passes.
  • Wheel and sdist build successfully and both pass twine check.

CVA6 remains pinned to v5.3.0. Upstream release, master revision and issue #3594 were rechecked and are unchanged from the prior 0.7.35 validation.

@xtofalex
xtofalex merged commit 662fe41 into main Nov 19, 2026
21 of 22 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant