🤖 [BEEP BOOP, A BOT WROTE THIS PR - Mistral Large 4, opencode] Merges `starbase/main` (3c895c5) into `main` and syncs Starbase-managed updates. Rebuilt from the current heads of `origin/main` and `starbase/main` per the refresh procedure, superseding the earlier merge PR (#203, now closed) after all preparation PRs landed. ## Starbase changes pulled in - Docs tooling: Sphinx Stack 2.0 overhaul (`docs/.sphinx` -> `docs/_dev`, new `docs/Makefile` and `requirements.txt`, `_templates`, rediraffe redirects, sphinx-llm/llms.txt support, osv-scanner config) - Workflows: updated check-renovate, policy, tics (project set to debcraft), release-publish, new copilot-setup-steps and zizmor configs, actionlint config, setup-uv v10, refreshed GitHub Actions pins - Tooling: tombi and shfmt wired into common.mk/pre-commit, ruff hook renamed to ruff-check, ruff select gains TC001-3, per-file-ignores gains PLR0917, mypy/pyright dropped upstream - Docs scaffold: new quadrant index pages with meta descriptions, `how-to-guides` renamed to `how-to`, `docs/redirects.txt` mechanism - Templates: AGENTS.app.md/AGENTS.lib.md scaffold and .editorconfig TOML baseline ## Conflict resolution - Took `starbase/main` for starbase-owned files (common.mk, check-renovate/policy/release-publish/tics workflows, .pre-commit-config.yaml, .editorconfig, docs/Makefile, docs/requirements.txt, docs/_dev/*, docs/_templates/*, actionlint/zizmor/osv-scanner configs); tics.yaml additionally sets `with.project: debcraft` - `.pre-commit-config.yaml`: starbase's ruff-check hook id and shfmt hook, but kept the child's newer ruff-pre-commit pin (v0.17.1 over starbase's v0.17.0) to avoid a hook downgrade - Kept child versions of `qa.yaml`, `CONTRIBUTING.md`, `AGENTS.md` and `uv.lock` (regenerated after the pyproject changes); kept `.github/README.md` and `tests/unit/starbase/` deleted (starbase scaffold test not needed in child repositories); kept the AGENTS templates deleted - `pyproject.toml`: kept the child `[project]`, dependency-groups (including dev-stonking/dev-tenacious), `[tool.uv]` extras and ruff src/target-version; took starbase's `docs-sphinx-stack` group verbatim (renamed from `docs-starter-pack`) and ruff select/per-file-ignores; kept the child's N818 ignore and the raised oauthlib/urllib3 constraint floors - `Makefile`: kept PROJECT, the active distro-codename group block, libgit2-dev APT package and schema target; took starbase's format/lint structure; set `DOCS_VENVDIR=../.venv-docs` so docs install into a separate venv outside `docs/` (Sphinx must not read the venv) - `docs/conf.py`: starbase scaffold with child values (project, author, ogp_*, html_context URLs, GPL-3.0 license, llms_txt_description derived from the docs/index.rst opening sentence); copyright start year 2023 - Docs pages kept with Debcraft substitutions; `how-to-guides` -> `how-to` rename with the matching `docs/redirects.txt` entry; scoped vale ignores for the Starbase mentions in docs/README.md (proper noun, not added to the custom wordlist) - `docs/.custom_wordlist.txt`: did NOT add "Starbase" (forbidden); otherwise unchanged ## Preparation PRs (all merged before this PR was opened) - #200 style: format pyproject.toml with tombi - #201 docs: add AGENTS.md for Debcraft - #202 fix: silence ty invalid-assignment for the Debian templater pattern - #204 build(deps): raise oauthlib constraint floor for OSV findings - #205 docs: reword "PRs" to "pull requests" for Vale spellcheck - #208 build(deps): add dev-stonking and dev-tenacious dependency groups - #209 fix(docs): update starflow intersphinx URL - #210 fix: suppress ty override diagnostics in the project model - #211 build(deps): update pre-commit hook astral-sh/ruff-pre-commit to v0.17.1 ## Validation - `make format`: all formatters pass - `make lint`: ruff, ty, codespell, prettier, shfmt, shellcheck, tombi, sphinx-lint, spelling, woke, linkcheck, twine, uv-lockfile, actionlint all pass - `make docs`: build succeeded; redirect confirmed `(good) how-to-guides/index.html --> how-to` - `make test-fast`: 245 passed, 1 skipped