From d190980f4779108571cfc75b988ea6a5f15b6606 Mon Sep 17 00:00:00 2001 From: Alexandre Teixeira Date: Tue, 28 Jul 2026 18:28:31 +0100 Subject: [PATCH] docs: classify test planning documents --- tests/LAYOUT_INVENTORY.md | 17 +++++++++++++++++ tests/OVERSIZED_TEST_SPLIT_PLAN.md | 4 ++++ tests/tools/build_oversized_test_split_plan.py | 4 ++++ 3 files changed, 25 insertions(+) diff --git a/tests/LAYOUT_INVENTORY.md b/tests/LAYOUT_INVENTORY.md index 4a14961be..60a9b7c63 100644 --- a/tests/LAYOUT_INVENTORY.md +++ b/tests/LAYOUT_INVENTORY.md @@ -10,6 +10,23 @@ - **Implemented by:** #3842 - **Status:** completed historical snapshot +- **Durable testing policy:** [`TESTING_STANDARD.md`](./TESTING_STANDARD.md) +- **Current testing mechanics:** [`README.md`](./README.md) + +## Disposition + +This document is retained as a non-canonical historical record of the completed +CLI test relocation. + +Reusable testing rules are maintained in `TESTING_STANDARD.md`; current helper, +taxonomy-runner, and execution mechanics are maintained in `README.md`, the test +suite, and its supporting code. + +Counts, residual-file observations, and path listings in this document are +snapshot evidence only. They must not be maintained as durable repository truth. + +Any additional test relocation requires a separately approved issue or work item. + ## Purpose This document preserves the reasoning, scope, and validation contract for the diff --git a/tests/OVERSIZED_TEST_SPLIT_PLAN.md b/tests/OVERSIZED_TEST_SPLIT_PLAN.md index 481424e58..442b6c83c 100644 --- a/tests/OVERSIZED_TEST_SPLIT_PLAN.md +++ b/tests/OVERSIZED_TEST_SPLIT_PLAN.md @@ -2,6 +2,10 @@ > [!NOTE] > This is generated planning material based on the current test tree. +> +> It is non-canonical and disposable. Durable testing policy belongs in +> `tests/TESTING_STANDARD.md`; active split selection and prioritization +> belong in approved issues or the project tracker. > It does not define runtime behaviour or approve any test-file split. ## Purpose diff --git a/tests/tools/build_oversized_test_split_plan.py b/tests/tools/build_oversized_test_split_plan.py index 671b646d5..ac2499fdc 100644 --- a/tests/tools/build_oversized_test_split_plan.py +++ b/tests/tools/build_oversized_test_split_plan.py @@ -443,6 +443,10 @@ def write_report(metrics: list[FileMetric], node_count_total: int) -> None: "", "> [!NOTE]", "> This is generated planning material based on the current test tree.", + ">", + "> It is non-canonical and disposable. Durable testing policy belongs in", + "> `tests/TESTING_STANDARD.md`; active split selection and prioritization", + "> belong in approved issues or the project tracker.", "> It does not define runtime behaviour or approve any test-file split.", "", "## Purpose",