upf: add supply-net commands, upf_version, and supply options (#5617)

[saurav-fermions]

Summary

Adds a coherent, tested subset of the UPF supply-net commands, upf_version, and supply options that the UPF reader was missing, mapped onto existing ODB structures. Scoped conservatively: anything requiring new ODB schema is explicitly deferred.

Type of Change

• New feature

Impact

UPF scripts using the added commands now parse and apply instead of erroring; existing flows unaffected.

Verification

• Local build succeeds.
• Relevant tests pass (rebuilt from source): ctest -R '^upf\.' 5/5.
• Code follows the repository's formatting guidelines.
• I have signed my commits (DCO).

Related Issues

Fixes #5617

---

Developed with SAIGE, Fermions' autonomous RTL/EDA debugging agent; root-caused, tested, and signed off by the submitter (@saurav-fermions).

[gemini-code-assist]

Code Review

This pull request introduces support for UPF supply ports, supply nets, and versioning in OpenROAD. Since the odb schema lacks dedicated objects for these constructs, they are persisted as string properties on the block, power domain, or isolation strategy. The changes include new C++ functions, SWIG/Tcl bindings, and integration tests. Feedback is provided regarding connect_supply_net, which currently overwrites the connection property with the last port specified; it should instead append ports to support connecting a supply net to multiple supply ports.

[gemini-code-assist]

Currently, connect_supply_net overwrites the connection property kSupplyNetConnPrefix + net with the last port specified. In UPF, a supply net can be connected to multiple supply ports (e.g., via -ports {VDD1 VDD2}). To support multiple port connections correctly, we should append the port to the existing space-separated list of ports instead of overwriting it.

  const std::string conn_prop = kSupplyNetConnPrefix + net;
  odb::dbStringProperty* prop = odb::dbStringProperty::find(block, conn_prop.c_str());
  if (prop != nullptr) {
    std::string existing = prop->getValue();
    if (!existing.empty() && !port.empty()) {
      existing += " " + port;
    } else if (existing.empty()) {
      existing = port;
    }
    prop->setValue(existing.c_str());
  } else {
    odb::dbStringProperty::create(block, conn_prop.c_str(), port.c_str());
  }

[maliberty]

Code should be formatted with clang-format

src/upf/src/upf.cpp:84:30: error: code should be clang-formatted [-Wclang-format-violations]
  odb::dbStringProperty* prop = odb::dbStringProperty::find(block, name.c_str());
                             ^
src/upf/src/upf.cpp:220:30: error: code should be clang-formatted [-Wclang-format-violations]
  odb::dbStringProperty* prop

[saurav-fermions]

Both addressed: clang-format is clean now, and connect_supply_net appends to a de-duplicated, space-separated list instead of overwriting — the tcl wrapper calls it once per port, so multi-port nets were losing all but the last port. I also extended supply.tcl to cover the multi-port case (it fails on the old overwrite behavior and passes now).

[maliberty]

Needs a tclfmt as well. @LucasYuki I'll leave the functional review to you.

[saurav-fermions]

Done — ran tclfmt on supply.tcl (it's clean now) and rebuilt + re-ran upf.supply, still passing. Thanks @LucasYuki, over to you for the functional review.