[dangertoaster]

🤖 This message was generated by kimi-k3.

Summary

Merges starbase/main (bdab610) into craft-cli, syncing Starbase-managed build tooling, CI workflows, and docs scaffolding.

Starbase changes pulled in

• CI workflows: new actionlint, zizmor, and copilot-setup-steps configs; updated check-renovate, policy, release-publish, and TICS workflows
• Build tooling: common.mk updates (new lint-code, lint-uv-lockfile, lint-actions, format-shfmt/lint-shfmt, format-tombi/lint-tombi targets); ruff-pre-commit bumped to v0.17.0
• Docs tooling: Sphinx Stack updates (sitemap, llms.txt, sphinx-rerediraffe 0.3.0, meta descriptions on Diátaxis landing pages)
• osv-scanner configuration

Conflict resolution

Per the file-ownership map (27 conflicts resolved): child-owned files kept (CODEOWNERS, qa.yaml, uv.lock, README.md, CONTRIBUTING.md, tests/, docs pages with Starcraft→Craft CLI substitutions); starbase-owned files taken verbatim (common.mk, workflow files, .pre-commit-config.yaml with the newer ruff pin, docs-sphinx-stack group); mixed-ownership files merged per section (pyproject.toml, Makefile, docs/conf.py, wordlist). Deleted per library-repo rules: docs/release-notes/, .github/README.md, tests/unit/starbase/, AGENTS templates, and the stale docs/.sphinx/ leftover.

Preparation PRs (must merge before this comes out of draft)

• test: make completion test robust to shfmt formatting #505 — test: make completion test robust to shfmt formatting (the merge's lint-shfmt target fails on tests/integration/test_completion/expected_script.sh until this lands)
• style: format pyproject.toml with tombi #506 — style: format pyproject.toml with tombi (the merge's lint-tombi target fails until this lands)

Once both merge, this branch will be rebased onto main so those changes drop out of this diff.

Validation

• make docs — passes (all redirects report (good))
• lint-ruff, lint-ty, lint-codespell, lint-prettier, lint-shellcheck, lint-twine, lint-uv-lockfile, lint-actions — pass
• lint-shfmt — fails on tests/integration/test_completion/expected_script.sh; fixed by test: make completion test robust to shfmt formatting #505
• lint-tombi — fails on pyproject.toml; fixed by style: format pyproject.toml with tombi #506
• lint-docs — fails because sphinx-lint scans the local docs/.venv; upstream issue filed: common.mk docs-lint: sphinx-lint scans docs/.venv starbase#635 (the merge adds docs/.venv/ to .gitignore; the sphinx-lint ignore needs a starbase-side fix)
• make test-fast — all pass except test_completion_output, fixed by test: make completion test robust to shfmt formatting #505

Follow-up commits

• fix: remove stale noqa directives and ignore docs/.venv — RUF100 cleanups required by the merge's ruff rule additions, plus docs/.venv gitignore entry

[dangertoaster]

🤖 [BEEP BOOP, A BOT WROTE THIS COMMENT - kimi-k3, opencode]

Provenance for files kept verbatim from this repository (no diff in this PR)

The following files were involved in merge conflicts during the Starbase sync but resolved entirely in favor of the existing craft-cli content, so they do not appear in this PR's file list:

• .github/workflows/qa.yaml, .github/CODEOWNERS, uv.lock, tests/conftest.py — child-owned per the Starbase file-ownership map; kept this repository's version (--ours). uv.lock was additionally regenerated with uv lock after the pyproject.toml docs-group merge to satisfy the new lint-uv-lockfile check.
• README.md — kept the craft-cli README; the Starbase README is a scaffold for new projects.
• CONTRIBUTING.md — kept the craft-cli contribution guide (library repositories keep their repository-specific guide).
• AGENTS.md — kept this repository's file authoritative per the AGENTS template rule, using AGENTS.lib.md as reference only; both template files (AGENTS.app.md, AGENTS.lib.md) are deleted for this library repository.
• docs/index.rst, docs/explanation/documentation.rst, docs/README.md — kept the craft-cli documentation pages.
• docs/.sphinx/spellingcheck.yaml (deleted) — leftover from the already-completed .sphinx → _dev migration; removed per the deletion checklist. Also deleted without diff: docs/release-notes/, .github/README.md, and tests/unit/starbase/test_init.py (library-repository rule 1b).
• .readthedocs.yaml — merged cleanly; the only difference from starbase is the pre-existing, documented fail_on_warning exemption (Fix all warnings in RTD builds #342).

[dangertoaster]

🤖 [BEEP BOOP, A BOT WROTE THIS COMMENT - kimi-k3, opencode]

History rewritten and force-pushed

The merge commit was rebuilt from current heads (per the stale-PR refresh procedure — no layered merge commits):

• New commits pulled from origin/main: test: make completion test robust to shfmt formatting #505 (shfmt-robust completion test), style: format pyproject.toml with tombi #506 (tombi pyproject formatting), build(deps): update pre-commit hook astral-sh/ruff-pre-commit to v0.17.1 (main) #509 (ruff-pre-commit v0.17.1). Those changes no longer appear in this PR's diff.
• New commits pulled from starbase/main (bdab610 → 1b92e7b): action pin bumps in copilot-setup-steps, and docs: instruct agents to never run 'make -C docs' (#636) — adopted into this repo's AGENTS.md per the library-template rule.
• All follow-up fixes preserved and squashed into the single merge commit: the stale noqa removal (RUF100) and the CONTRIBUTING.md leftover-marker fix.
• Notable resolution change this round: .pre-commit-config.yaml keeps origin/main's newer ruff-pre-commit pin (v0.17.1, with the renamed ruff hook id) per the never-downgrade rule — Starbase is at v0.17.0.

Full validation passes on the rebuilt branch: make format, make lint (including lint-docs), make docs, make test-fast (909 passed, 1 skipped).