From ad169f5309aa199c7f2a62c806b928c53eaa39a3 Mon Sep 17 00:00:00 2001 From: Branimir Georgiev <66906831+braboj@users.noreply.github.com> Date: Wed, 21 Oct 2026 23:18:17 +0300 Subject: [PATCH] docs(migration): list the renames a fork's sync merge meets (#2057) Tool, test-kit, wrapper, spec and lint-config renames, each with the edit a fork's own files need, checked against the Imbra fork's tree. Co-Authored-By: Claude Opus 5.5 --- docs/migrating-to-v3.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/docs/migrating-to-v3.md b/docs/migrating-to-v3.md index f9e1cd85..448e7579 100644 --- a/docs/migrating-to-v3.md +++ b/docs/migrating-to-v3.md @@ -135,6 +135,27 @@ pre-split text after `-s ours`; the Imbra fork moved its own procedures to into `CONTRIBUTING.md`, and replaces `docs/SPEC.md` with `docs/spec.md` and `docs/architecture/`; a fork takes all three with the merge. +### Renames the merge meets + +Git carries upstream's own files through each rename. The fork's files +that name an old path do not follow, so edit them in the merge: + +| Upstream change | Fork action | +| --------------- | ----------- | +| Tools named verb-first: `resolve.py`, `sync.py`, `release_check.py`, `template_quality.py` become `resolve_chain.py`, `sync_docs.py`, `check_release.py`, `score_templates.py` ([#2052]) | Update every call and mention in `tests/fork_checks.py`, `tests/fork_dispositions.py`, `tests/cases.py`, `tests/run_e2e.py` and `tools/fork_examples.py` | +| `tests/lib.py` becomes `tests/testkit/` ([#2053], [#2055]) | `from lib import` becomes `from testkit import` | +| One wrapper runs every suite: `py tests/run.py ` ([#2055]) | Move `tests/run_e2e.py` to `tests/e2e/run.py`; replace `py tests/run_smoke.py` with `py tests/run.py smoke` | +| Specs move from `tests/specs/` to `docs/tests/specs/` ([#2053]) | Move the fork's own specs there | +| The lint config moves from the root to `.github/linters/` ([#2049]) | Keep the fork's `.markdownlint.json`; its checks read the `prose` and `decision_layout` keys | + +`tests/fork_checks.py` and `tests/fork_dispositions.py` stay where they +are: the smoke and conformance runners import them from `tests/`. + +[#2049]: https://github.com/solid-ai-dev/solid-ai-templates/pull/2049 +[#2052]: https://github.com/solid-ai-dev/solid-ai-templates/pull/2052 +[#2053]: https://github.com/solid-ai-dev/solid-ai-templates/pull/2053 +[#2055]: https://github.com/solid-ai-dev/solid-ai-templates/pull/2055 + ### Traps | Trap | What happens | Fix |