UPF: add upf_version

[DivyanshuX9]

Title: UPF: add upf_version command support

This PR resolves part of Issue #5617 by implementing the upf_version command

Changes made:

• Added upf_version API in upf.h
• Implemented command handler in upf.cpp
• Added SWIG interface binding in upf.i
• Added Tcl command parsing in upf.tcl

Behavior:

• Parses upf_version <version>
• Stores version in dbBlock using setUPFVersion()
• Emits warning if version string is missing
• Does not affect existing flow

Implementation strategy:
This follows the incremental approach discussed in Issue #5617:

• Implement one command at a time
• Ensure build stability
• Avoid documentation updates until multiple commands are finalized
• Keep PR small and reviewable

This PR corresponds to Phase 1:
Basic UPF command support

Next planned commands:

• create_supply_port
• create_supply_net
• connect_supply_net

No documentation files were modified in this PR as per incremental workflow.

Related issue:
#5617

[gemini-code-assist]

Code Review

This pull request introduces the upf_version command. The implementation is straightforward, but there's an issue with error handling. Currently, if an invalid version string is provided, the Tcl command succeeds while only printing a warning. My feedback focuses on propagating the error status from the C++ layer to the Tcl script to ensure the command fails correctly, which is more consistent with typical command-line tool behavior.

[gemini-code-assist]

The upf_version_cmd function should propagate the success/failure status from upf::upf_version. This allows the Tcl script to handle errors properly. Please change the return type to bool and return the result of the call.

  bool upf_version_cmd(const char* version) {
    odb::dbDatabase* db = getOpenRoad()->getDb();
    return upf::upf_version(getOpenRoad()->getLogger(), db->getChip()->getBlock(), version);
  }

[gemini-code-assist]

The Tcl command should check the return value of upf::upf_version_cmd and report an error if it fails. This ensures that invalid calls (e.g., with an empty version string) cause the Tcl command to fail, which is standard practice. This change depends on the suggested change in src/upf/src/upf.i.

  if {![upf::upf_version_cmd $version]} {
    sta::error "Failed to set UPF version."
  }

[DivyanshuX9]

Bro I Updated the implementation to propagate the return status
from C++ to Tcl as per your suggestion
Changed upf_version_cmd to return bool, Updated Tcl to check return value, Fixed function signature in header
Also fixed my commit with Signed-off-by for DCO.

Please review again.

[github-actions]

clang-tidy review says "All clean, LGTM! 👍"