🤖 [BEEP BOOP, A BOT WROTE THIS PR - Mistral Large 4, opencode] Merges `starbase/main` (a310931, including starbase#617) into `main` and syncs Starbase-managed updates. Rebuilt from fresh `origin/main` + `starbase/main` heads per the refresh procedure (no layered merge commit; no prior PR existed for this branch). ## 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 (incl. starbase#617), new copilot-setup-steps and zizmor configs, actionlint config - Tooling: tombi and shfmt wired into common.mk/pre-commit; ruff hook renamed to ruff-check; ruff select gains TC001-3 and per-file-ignores gains PLR0917 - 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` - Kept child versions of `qa.yaml` (child-owned; no net diff) and `uv.lock` (regenerated after the pyproject dependency-group changes; also corrects a stale craft-platforms pin) - `pyproject.toml`: kept the child `[project]`, dependency-groups, `[tool.uv]` extras and ruff src/target-version; took starbase's `docs-sphinx-stack` group verbatim (renamed from `docs-starter-pack`); merged `constraint-dependencies` (identical entries, alphabetized); kept the child's N818 ruff ignore - `Makefile`: kept PROJECT, the active distro-codename groups, libgit2-dev APT package and schema target; took starbase's format/lint structure (lint-code without mypy/pyright, which debcraft does not configure); 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 (first commit) - Docs pages kept with Debcraft substitutions; `how-to-guides` -> `how-to` rename with a `redirects.txt` entry; README opening sentence added to docs/index.rst as the intro for the meta description and llms.txt - `AGENTS.md` derived from the starbase `AGENTS.app.md` template; both template files kept deleted; `.github/README.md` and `qa.yaml` unchanged (child already had them that way) - `.prettierignore`: kept child entries, updated the `.sphinx` -> `_dev` path - `docs/.custom_wordlist.txt`: did NOT add "Starbase" (forbidden); otherwise unchanged - Removed `html_css_files`/`html_js_files` references to the deleted cookie-banner.css and bundle.js ## Pending preparation PRs (draft, to merge before this PR is marked ready) - #200 style: format pyproject.toml with tombi (mechanical reformat split per policy) — approved - #201 docs: add AGENTS.md for Debcraft (template-derived file split per policy) — draft - #202 fix: silence ty invalid-assignment for the Debian templater pattern (pre-existing ty 0.0.85 drift; also blocks main's next lint run) — approved - #204 build(deps): raise oauthlib and urllib3 constraint floors for OSV findings (pre-existing; main's Check policy workflow has been red on these since 2026-10-01) — review required - #205 docs: reword "PRs" to "pull requests" for Vale spellcheck (pre-existing wording surfaced by the synced docs-lint; fixes this PR's spelling failure) — draft, docs-lint green in CI ## Validation - `make format`: all formatters pass (on this host, `make format`'s pre-commit step hits a `uv tool run` snap quirk that also affects main; verified equivalent via the pre-commit entrypoint directly: exit 0) - `make lint`: ruff, codespell, prettier, shfmt, shellcheck, tombi, sphinx-lint, woke, linkcheck, twine, uv-lockfile, actionlint all pass. Known exceptions, all covered by preparation PRs: lint-ty (helpers.py, fixed by #202), docs spelling `PRs` (fixed by #205), OSV-scanner (oauthlib/urllib3, fixed by #204) - `make docs`: build succeeded; redirect confirmed `(good) how-to-guides/index.html --> how-to` - `make test-fast`: 245 passed, 1 skipped