🤖 This message was generated by kimi-k3 ## Summary Merges `starbase/main` (bdab610) into main, syncing Starbase-managed updates: - **Build system**: new lint targets (shfmt, tombi, actionlint), `lint-code` aggregate target, coverage config relocated, ruff config updates (2-space → 4-space reformat plus new test per-file-ignores PLR0917/FBT001/FBT002), pre-commit ruff bumped to v0.17.0 with the new `shfmt` hook. - **Workflows**: new `.github/actionlint.yaml`, `.github/workflows/copilot-setup-steps.yaml`, `.github/zizmor.yaml`; explicit permissions on policy/release-publish/tics; TICS now takes an explicit `TICSAUTHTOKEN` secret. - **Docs tooling**: Sphinx Stack updates (sphinx-sitemap 2.9, `slug` config, sphinx-llm, rerediraffe), `docs/_dev` scripts, rewritten docs README describing the new update process, new `docs/explanation/documentation.rst` page (adapted to Rockcraft naming and added to the explanation toctree). - **Dependencies**: `docs-sphinx-stack` group is now fully Starbase-owned (sphinx-tabs, sphinx-ubuntu-images, sphinx-youtube-links, svg2pdfconverter disabled); `uv.lock` regenerated. - **AGENTS scaffold**: `AGENTS.md`/`AGENTS.lib.md`/`AGENTS.app.md` templates were taken as reference and deleted (rockcraft has no repo-level AGENTS.md; the scaffold text describes the starcraft scaffold package, not rockcraft). ## Conflict resolution highlights - Kept child-owned files: `.github/CODEOWNERS`, `.github/workflows/qa.yaml`, `docs/{explanation,how-to,index,reference,release-notes}/index.rst`, `docs/.custom_wordlist.txt` (child superset; deliberately did **not** add `Starbase`/`Starcraft` per policy), and `tests/`. - Took starbase-owned files verbatim: `common.mk`, `policy.yaml`, `release-publish.yaml`, `check-renovate.yaml`, `.pre-commit-config.yaml` (all pins newer — verified no hook downgrades), `docs/{README.md,Makefile,.gitignore,requirements.txt}`, `docs/_dev/*`, `osv-scanner.toml`. - `tics.yaml`: starbase structure with `with.project` set to `"rockcraft"`. - `Makefile`: starbase structure + child-owned `PROJECT=rockcraft`, uncommented VERSION_CODENAME dev-groups block (rockcraft has distro-specific dev groups), `pack-snap`, schema targets, extra APT packages, `install-ajv-cli`. - `docs/conf.py`: starbase scaffold with child-owned values (project, URLs, license, slug, llms_txt_description, copyright start 2022, linkcheck/exclude additions, extensions, intersphinx mappings, CLI-docs automation, common-docs symlinks, notfound config). - `pyproject.toml`: child-owned `[project]`, `[dependency-groups]` (except starbase-owned `docs-sphinx-stack`), `[build-system]`, `[tool.uv]` (constraint superset kept), `[tool.ty.src]`; starbase-owned `[tool.setuptools_scm]` (write_to adapted), `[tool.ruff]` (with rockcraft src/extend-exclude and PLC0415 ignore), `[tool.coverage]`, `[tool.isort]`, `[tool.codespell]`. Stray orphaned mypy settings under `[tool.coverage.report]` were dropped (mypy was replaced by ty in 5d9356c; starbase likewise dropped mypy/pyright in 1104bc6). - `CONTRIBUTING.md`: starbase template with Rockcraft substitutions (GPL-3.0, Matrix channel, test-suite description, release-notes link). - `.prettierignore`: starbase baseline + rockcraft-specific entries kept (`schema/rockcraft.json`, `tools/external`) marked as repository-specific additions; dropped obsolete `docs/sphinx-docs-starter-pack` entry (path no longer exists). - Kept deleted: `.github/README.md` (child-side deletion), `docs/tutorials/index.rst` (a symlink to ../how-to/index.rst here), `tests/unit/starbase/test_init.py` (scaffold-only test). ## Pending preparation PRs These pre-existing/unrelated fixes were split out so the merge diff stays reviewable; this PR should not be marked ready until they merge: - #1396 — style: fix findings from ruff 0.17, shfmt, and tombi (test fixtures + tools) - #1397 — style(ci): fix actionlint findings in schema and snap workflows Once those merge, this branch will be rebased so their changes drop out of this diff. ## Validation - `make docs` ✅ (builds clean, all redirects report `(good)`) - `make docs-lint` ✅ (sphinx-lint, vale spelling/woke — 0 errors in 156 files) - `make test-fast` ✅ (652 passed, 1 skipped) - `make lint`: ruff/shfmt/actionlint failures correspond exactly to the two prep PRs above plus failures already present on `main` (ty diagnostics; ruff findings under the unpinned snap ruff 0.17). - Follow-up commits on this branch: docs README vale inline-ignore for the legitimate `Starbase` proper-noun references (template file that must reference the upstream repo), and the mechanical tombi reformat of `pyproject.toml` (parsed TOML verified identical modulo ordering).