talumbau · Oct 9, 2026 · Aug 12, 2026 · Aug 18, 2026 · Aug 18, 2026 · Aug 18, 2026
@@ -150,8 +150,8 @@
 /projects/hipblaslt/library/include/                @ROCm/hipblaslt-reviewers @ROCm/hipblaslt-docs-reviewers
 
 # Internal engineering decision logs, not user-facing docs: skip the docs-reviewers group.
-/projects/hipblaslt/tensilelite/Tensile/Tests/unit/characterization/DECISIONS.md   @ROCm/hipblaslt-reviewers
-/projects/hipblaslt/tensilelite/Tensile/Tests/unit/characterization/adr/           @ROCm/hipblaslt-reviewers
+/projects/hipblaslt/tensilelite/tensilelite/Tests/unit/characterization/DECISIONS.md   @ROCm/hipblaslt-reviewers
+/projects/hipblaslt/tensilelite/tensilelite/Tests/unit/characterization/adr/           @ROCm/hipblaslt-reviewers
 
 /projects/hipccl/**/*.md                            @ROCm/prims-rands-reviewers @ROCm/prims-docs-reviewers
 /projects/hipccl/**/*.rst                           @ROCm/prims-rands-reviewers @ROCm/prims-docs-reviewers

@@ -33,7 +33,7 @@ ROCJITSU_CONFIG="${ROCJITSU_CONFIG:-}"
 RACE_REPORT_DIR="${RACE_REPORT_DIR:-${PWD}/race-reports}"
 HIPBLASLT_BENCH="${HIPBLASLT_BENCH:-${ROCM_PATH}/bin/hipblaslt-bench}"
 TENSILELITE_ROOT="${TENSILELITE_ROOT:-${ROCM_PATH}/share/hipblaslt/tensilelite}"
-TENSILE_DRIVER="${TENSILE_DRIVER:-${TENSILELITE_ROOT}/Tensile/bin/Tensile}"
+TENSILE_DRIVER="${TENSILE_DRIVER:-${TENSILELITE_ROOT}/tensilelite/bin/Tensile}"
 TENSILELITE_CLIENT="${TENSILELITE_CLIENT:-${ROCM_PATH}/libexec/hipblaslt/tensilelite/tensilelite-client}"
 RACE_TIMEOUT_SECONDS="${RACE_TIMEOUT_SECONDS:-180}"
 TENSILELITE_TIMEOUT_SECONDS="${TENSILELITE_TIMEOUT_SECONDS:-420}"

@@ -133,7 +133,7 @@ jobs:
         working-directory: projects/hipblaslt/tensilelite
         run: |
           PY=.tox/coverage-unit/bin/python
-          "$PY" Tensile/Tests/unit/characterization/tools/coverage_split_summary.py \
+          "$PY" tensilelite/Tests/unit/characterization/tools/coverage_split_summary.py \
             --characterization char.json --unit unit.json --combined coverage.json \
             --characterization-junit char_tests.xml --unit-junit unit_tests.xml || true
           exit 0

@@ -208,7 +208,7 @@ jobs:
             export Tensile_ASM_COMPILER_LAUNCHER=ccache Tensile_CXX_COMPILER_LAUNCHER=ccache
             ccache -z >/dev/null 2>&1 || true
           fi
-          pytest -p no:cacheprovider Tensile/Tests/common \
+          pytest -p no:cacheprovider tensilelite/Tests/common \
             -m "gfx1250 and not skip-gfx1250" "${K_ARG[@]}" --timeout=5400 -n 1 -v -rfxX \
             --gpu-targets "$TL_TARGET" \
             --prebuilt-client="$ROCM/libexec/hipblaslt/tensilelite/tensilelite-client" \

@@ -729,7 +729,8 @@ endif()
 
 # Install TensileLite Python packages and test tools for artifact-based testing.
 # Produces:
-#   share/hipblaslt/tensilelite/Tensile/     — Tensile Python package
+#   share/hipblaslt/tensilelite/tensilelite/ — Tensile Python package
+#   share/hipblaslt/tensilelite/Tensile/     — legacy import compatibility shim
 #   share/hipblaslt/tensilelite/rocisa/       — rocisa Python package (normalized layout)
 #   share/hipblaslt/tensilelite/rocisa_tests/ — rocisa pytest modules
 if(HIPBLASLT_INSTALL_TENSILELITE_TEST_ARTIFACTS AND NOT WIN32)
@@ -738,13 +739,18 @@ if(HIPBLASLT_INSTALL_TENSILELITE_TEST_ARTIFACTS AND NOT WIN32)
 
     # Tensile Python package
     install(
-        DIRECTORY "${_tensilelite_src}/Tensile/"
-        DESTINATION "${_tensilelite_install_dest}/Tensile"
+        DIRECTORY "${_tensilelite_src}/tensilelite/"
+        DESTINATION "${_tensilelite_install_dest}/tensilelite"
         COMPONENT tests
         PATTERN "__pycache__" EXCLUDE
         PATTERN ".pytest_cache" EXCLUDE
         PATTERN "*.pyc" EXCLUDE
     )
+    install(
+        FILES "${_tensilelite_src}/Tensile/__init__.py"
+        DESTINATION "${_tensilelite_install_dest}/Tensile"
+        COMPONENT tests
+    )
 
     # Scripts used by unit tests
     install(
@@ -768,9 +774,9 @@ if(HIPBLASLT_INSTALL_TENSILELITE_TEST_ARTIFACTS AND NOT WIN32)
     # Preserve executable permissions on entry points
     install(
         PROGRAMS
-            "${_tensilelite_src}/Tensile/bin/Tensile"
-            "${_tensilelite_src}/Tensile/bin/TensileCreateLibrary"
-        DESTINATION "${_tensilelite_install_dest}/Tensile/bin"
+            "${_tensilelite_src}/tensilelite/bin/Tensile"
+            "${_tensilelite_src}/tensilelite/bin/TensileCreateLibrary"
+        DESTINATION "${_tensilelite_install_dest}/tensilelite/bin"
         COMPONENT tests
     )
 

@@ -133,9 +133,9 @@ If you run from elsewhere, the test may not find the data file. For more run opt
 
 ## TensileLite Python tests (codegen / characterization)
 
-The sections above cover the **client** tests (`hipblaslt-test`, gtest, YAML data). The in-repo **TensileLite generator** has its own Python test suite under `tensilelite/Tensile/Tests/unit/`, including **characterization tests** that pin current behavior with [syrupy](https://github.com/syrupy-project/syrupy) `.ambr` golden files.
+The sections above cover the **client** tests (`hipblaslt-test`, gtest, YAML data). The in-repo **TensileLite generator** has its own Python test suite under `tensilelite/tensilelite/Tests/unit/`, including **characterization tests** that pin current behavior with [syrupy](https://github.com/syrupy-project/syrupy) `.ambr` golden files.
 
-If your change makes a characterization test fail, do **not** run a blanket `pytest --snapshot-update` (it rewrites every golden and destroys the safety net). Update only the affected node and review the diff. Full policy and the decision tree: [`tensilelite/Tensile/Tests/unit/characterization/README.md`](tensilelite/Tensile/Tests/unit/characterization/README.md).
+If your change makes a characterization test fail, do **not** run a blanket `pytest --snapshot-update` (it rewrites every golden and destroys the safety net). Update only the affected node and review the diff. Full policy and the decision tree: [`tensilelite/tensilelite/Tests/unit/characterization/README.md`](tensilelite/tensilelite/Tests/unit/characterization/README.md).
 
 ---
 

@@ -664,11 +664,11 @@ about "what do we currently know is broken" has to check all eight.
 | [`clients/tests/data/known_bugs.yaml`](clients/tests/data/known_bugs.yaml) | Client GTest cases matched by parameters, optionally per architecture. Excluded from every tier | Comment convention | **No.** The case never runs, so nothing can observe a fix |
 | `GTEST_SKIP()` in client sources | Individual cases at runtime | None | Not applicable, and mostly not bugs: these are environment guards (no GPU present, no Stream-K kernel selected for the problem) |
 | [`TensileLogic/known_bugs.yaml`](tensilelite/Tensile/TensileLogic/known_bugs.yaml) | Library-logic validation failures, keyed on logic file path plus `SolutionNameMin` | Structured `ticket:` field | **Partly.** Re-validates each entry and reports stale ones, but only warns |
-| Filename-driven marks in `Tensile/Tests/common/config_helpers.py` | Any config YAML whose path contains `xfail`, `wip` or `disabled` | None; the reason lives in a filename | **No**, and non-strict, so an expected failure that starts passing is silent |
+| Filename-driven marks in `tensilelite/Tests/common/config_helpers.py` | Any config YAML whose path contains `xfail`, `wip` or `disabled` | None; the reason lives in a filename | **No**, and non-strict, so an expected failure that starts passing is silent |
 | `skip-<arch>` marks in config YAML `TestParameters` | A config on named architectures | Free-text comment | Not applicable |
 | Explicit `pytest.mark.xfail` markers | Specific assertions in a Python test | Ticket in the `reason` string | **Yes**, when written `strict=True` |
 | Characterization goldens that pin known-wrong behavior | Nothing. The wrong behavior is recorded rather than hidden | ADR under `adr/` with a defect link, required by the reviewer checklist | Not applicable: a fix shows up as a golden diff needing review |
-| `_needs_logic_dir` environment-conditional `pytest.mark.skipif` ([`test_PlaceholderMerge.py`](tensilelite/Tensile/Tests/unit/test_PlaceholderMerge.py), duplicated in [`test_GpuRevisionTarget.py`](tensilelite/Tensile/Tests/unit/test_GpuRevisionTarget.py)) | The logic-corpus consistency checks described under [Logic-corpus consistency regression tests](tensilelite/TESTING.md#logic-corpus-consistency-regression-tests), whenever `library/.../Logic/asm_full` is not on disk | Issue URL in the `reason` string; no `strict`, no time-box | **No.** The condition tracks an environment, not the bug it guards; where that environment is permanent (see below) the check can never run for real regardless of what the data says |
+| `_needs_logic_dir` environment-conditional `pytest.mark.skipif` ([`test_PlaceholderMerge.py`](tensilelite/tensilelite/Tests/unit/test_PlaceholderMerge.py), duplicated in [`test_GpuRevisionTarget.py`](tensilelite/tensilelite/Tests/unit/test_GpuRevisionTarget.py)) | The logic-corpus consistency checks described under [Logic-corpus consistency regression tests](tensilelite/TESTING.md#logic-corpus-consistency-regression-tests), whenever `library/.../Logic/asm_full` is not on disk | Issue URL in the `reason` string; no `strict`, no time-box | **No.** The condition tracks an environment, not the bug it guards; where that environment is permanent (see below) the check can never run for real regardless of what the data says |
 
 This last mechanism is a different shape from the other seven: it is not quarantining a *known* bug
 at all, but gating on a precondition, and it lands in the same **Blind** tier as the client
@@ -690,7 +690,7 @@ quarantine list, is in the blind tier.
 
 **The best-governed example is already in the tree**, and is worth copying rather than redesigning.
 The `_ROCM3994_XFAIL` marker in
-[`test_amax_true16_activation.py`](tensilelite/Tensile/Tests/unit/test_amax_true16_activation.py)
+[`test_amax_true16_activation.py`](tensilelite/tensilelite/Tests/unit/test_amax_true16_activation.py)
 carries a ticket in its reason, `strict=True` so that a fix turns the unexpected pass into a hard
 failure, `raises=AssertionError` so an unrelated crash is not absorbed, a time-box comment naming
 when to re-evaluate, and an explicit instruction to delete the marker in the fixing PR. The test
@@ -888,7 +888,7 @@ When adding or modifying functionality:
 ### Choosing the Right Test Type
 
 - **Can the behavior be validated without GPU hardware?**
-  - Yes, and it is in TensileLite Python: add a unit test in `tensilelite/Tensile/Tests/unit/`. Write
+  - Yes, and it is in TensileLite Python: add a unit test in `tensilelite/tensilelite/Tests/unit/`. Write
     a test that asserts what the code *should* do. Reach for a characterization golden only when you
     are pinning behavior that already exists so it can be refactored safely, not when you are adding
     behavior.

@@ -162,10 +162,10 @@ function(create_device_library)
             "create_device_library: CODEGEN_ROOT is required; pass the TensileLite source root "
             "or set HIPBLASLT_CODEGEN_ROOT.")
     endif()
-    set(_known_bugs_resource "${_codegen_dir}/Tensile/TensileLogic/known_bugs.yaml")
+    set(_known_bugs_resource "${_codegen_dir}/tensilelite/TensileLogic/known_bugs.yaml")
     foreach(_required_path
-            "${_codegen_dir}/Tensile/bin/TensileLogic"
-            "${_codegen_dir}/Tensile/TensileCreateLibrary/__main__.py"
+            "${_codegen_dir}/tensilelite/bin/TensileLogic"
+            "${_codegen_dir}/tensilelite/TensileCreateLibrary/__main__.py"
             "${_known_bugs_resource}")
         if(NOT EXISTS "${_required_path}")
             message(FATAL_ERROR "create_device_library: required codegen resource not found: ${_required_path}")
@@ -329,14 +329,14 @@ function(create_device_library)
     # .py generators, plus the packaged static headers (resources.py) and the
     # custom-kernel assembly (CustomKernels.py) that codegen reads as data.
     file(GLOB_RECURSE _codegen_sources LIST_DIRECTORIES false CONFIGURE_DEPENDS
-         "${_codegen_dir}/Tensile/*.py"
-         "${_codegen_dir}/Tensile/*.h"
-         "${_codegen_dir}/Tensile/*.s")
-    list(FILTER _codegen_sources EXCLUDE REGEX "/Tensile/Tests/")
+         "${_codegen_dir}/tensilelite/*.py"
+         "${_codegen_dir}/tensilelite/*.h"
+         "${_codegen_dir}/tensilelite/*.s")
+    list(FILTER _codegen_sources EXCLUDE REGEX "/tensilelite/Tests/")
     list(APPEND _codegen_dependencies
          ${_logic_files}
          ${_codegen_sources}
-         "${_codegen_dir}/Tensile/bin/TensileLogic")
+         "${_codegen_dir}/tensilelite/bin/TensileLogic")
 
     # ninja only compares mtimes of inputs that still exist, so a *removed* file
     # leaves the stamp clean (nothing is newer), as does a file added with an
@@ -355,7 +355,7 @@ function(create_device_library)
         OUTPUT "${_logic_stamp}"
         COMMENT "Validating library logic (TensileLogic --check-all) for ${_cdl_TARGET} ..."
         COMMAND ${_python_command}
-            "${_codegen_dir}/Tensile/bin/TensileLogic"
+            "${_codegen_dir}/tensilelite/bin/TensileLogic"
             ${_tensile_logic_args}
         COMMAND ${CMAKE_COMMAND} -E touch "${_logic_stamp}"
         DEPENDS ${_codegen_dependencies}
@@ -370,7 +370,7 @@ function(create_device_library)
     # Tensile is not yet importable.
     set(_output_stamp "${CMAKE_CURRENT_BINARY_DIR}/${_cdl_TARGET}.stamp")
     set(_tcl_command
-        ${_python_command} -m Tensile.TensileCreateLibrary
+        ${_python_command} -m tensilelite.TensileCreateLibrary
         ${_opts_list}
         "${_cdl_LOGIC_PATH}"
         "${_cdl_OUTPUT_DIR}"

@@ -12,7 +12,7 @@ or at runtime.
 ```
 
 UIDs are generated by
-`tensilelite/Tensile/Common/SolutionIdGen.py`. Internally, a UID remains an
+`tensilelite/tensilelite/Common/SolutionIdGen.py`. Internally, a UID remains an
 unsigned 64-bit integer. Human-readable files and command-line output use an
 unpadded base62 representation:
 
@@ -39,7 +39,7 @@ To replace one solution's UID after a duplicate is reported:
 
 ```bash
 cd projects/hipblaslt/tensilelite
-python3 -m Tensile.TensileGenerateUID path/to/logic.yaml --index 5 --inplace
+python3 -m tensilelite.TensileGenerateUID path/to/logic.yaml --index 5 --inplace
 ```
 
 `--index` is the solution's local `SolutionIndex` in that YAML file. Without

@@ -51,7 +51,7 @@ C++ unit → Tensile pytest → client/API → integration → perf. Pick the lo
 the regression. Map the base test-level table onto these lanes when advising or reviewing.
 
 ### Adds — characterization snapshot (`.ambr` golden) discipline
-Scope: `projects/hipblaslt/tensilelite/Tensile/Tests/unit/characterization/` — characterization tests
+Scope: `projects/hipblaslt/tensilelite/tensilelite/Tests/unit/characterization/` — characterization tests
 that pin TensileLite's *current* Python behavior as syrupy `.ambr` goldens, run in the `-m unit`
 lane. Green means "behavior unchanged," not "correct"; a red is information about the PR's own
 change. When a PR's diff touches any `.ambr` file, gate on all of the below.
@@ -105,8 +105,8 @@ while another adds *data the validator checks*. Treat these as a coupled pair ev
 different paths. The concrete hipBLASLt instance:
 - Validator / allow-list: `projects/hipblaslt/tensilelite/Tensile/Common/GlobalParameters.py` (the
   global-parameter registry and the `_assertGlobalParametersAreValid` ignored-key allow-list), plus
-  the enforcing test `projects/hipblaslt/tensilelite/Tensile/Tests/unit/test_input_yaml_corpus_clean.py`.
-- Validated data: YAML fixtures under `projects/hipblaslt/tensilelite/Tensile/Tests/**` (e.g.
+  the enforcing test `projects/hipblaslt/tensilelite/tensilelite/Tests/unit/test_input_yaml_corpus_clean.py`.
+- Validated data: YAML fixtures under `projects/hipblaslt/tensilelite/tensilelite/Tests/**` (e.g.
   `common/gemm/**`).
 
 If, since the PR diverged, the base branch changed the validator/allow-list **and** this PR adds or

@@ -11,10 +11,10 @@ source change.
 
 Start with evidence that another developer can review:
 
-1. Search recursively below `Tensile/Tests/unit/` for
+1. Search recursively below `tensilelite/Tests/unit/` for
    `test_<Module>.py`. Do not assume the file is directly below `unit/`; for
-   example, the direct tests for `Tensile/Common/Utilities.py` are in
-   `Tensile/Tests/unit/Common/test_Utilities.py`.
+   example, the direct tests for `tensilelite/Common/Utilities.py` are in
+   `tensilelite/Tests/unit/Common/test_Utilities.py`.
 2. Search unit tests and tests that record current behavior for imports or
    references to the target module.
 3. Include existing test directories whose fixtures or public API calls reach
@@ -23,7 +23,7 @@ Start with evidence that another developer can review:
    every addition or removal.
 
 Keep the set inside the `-m unit` suite. The YAML-driven directories under
-`Tensile/Tests/common` execute the same production code, but each config
+`tensilelite/Tests/common` execute the same production code, but each config
 compiles kernels and benchmarks them on real hardware, and a mutation run
 repeats the whole set once per mutant. Including them makes a run
 hardware-gated and turns minutes into hours. Accept the consequence: a kill
@@ -49,10 +49,10 @@ mkdir -p "$OUT"
 
 set +e
 docker exec -e PYTHONPATH="$PROJ" -w "$PROJ" tl-mut \
-  pytest -p no:cacheprovider -m unit --cov=Tensile/Common \
+  pytest -p no:cacheprovider -m unit --cov=tensilelite/Common \
   --cov-report=term-missing --cov-fail-under=0 \
-  Tensile/Tests/unit/Common/test_Utilities.py \
-  Tensile/Tests/unit/characterization/CommonUtilities \
+  tensilelite/Tests/unit/Common/test_Utilities.py \
+  tensilelite/Tests/unit/characterization/CommonUtilities \
   >"$OUT/coverage.log" 2>&1
 rc=$?
 set -e
@@ -72,7 +72,7 @@ Require all four scheduling conditions before starting the mutation run:
 
 1. Pytest exits with status `0`.
 2. The coverage report contains the exact target file, such as
-   `Tensile/Common/Utilities.py`.
+   `tensilelite/Common/Utilities.py`.
 3. That file's executed-line percentage meets the reviewed scheduling
    threshold. Use 80% unless the slice records another value.
 4. The selected list contains at least one explicit test path and is not an
@@ -90,11 +90,11 @@ directory:
 
 ```json
 {
-  "module": "Tensile/Common/Utilities.py",
+  "module": "tensilelite/Common/Utilities.py",
   "source_sha": "<commit>",
   "selected": [
-    "Tensile/Tests/unit/Common/test_Utilities.py",
-    "Tensile/Tests/unit/characterization/CommonUtilities"
+    "tensilelite/Tests/unit/Common/test_Utilities.py",
+    "tensilelite/Tests/unit/characterization/CommonUtilities"
   ],
   "command": "<exact command>",
   "exit_code": 0,