chore(merge): update starbase (2026-07-16)
Metadata
Current evaluation
PR #238 was closed unmerged after an external linkcheck timeout; its Starbase sync was later merged through replacement PR #252.
Resolution: closed superseded
Reason: The maintainer closed #238 unmerged because the only failure was a manpages.ubuntu.com timeout tracked in #247, and deferred a fresh attempt. That sync subsequently landed via merged PR #252.
Evaluated by: mr-cal-bot
No scores available.
Issue body
## Overview
Merges `canonical/starbase` main into craft-archives to pick up shared tooling, CI workflow, and documentation scaffolding updates.
### Key changes
- Adopted starbase's expanded Makefile targets and `common.mk` orchestration (new `format-shfmt`, `format-pre-commit`, `lint-ty`, `lint-shfmt`, `lint-shellcheck`, `lint-uv-lockfile`, `lint-actions`).
- Adopted the new Sphinx Stack docs scaffold (`docs/Makefile`, `docs/requirements.txt`, `docs/_dev/*`, `canonical-sphinx~=0.6`).
- Adopted new ruff lint rules (TC001-003, PLW1641, FBT001/FBT002); fixed the resulting violations.
- Adopted the new `ty` type-checker lint target.
- Kept craft-archives' own README.md, `qa.yaml`, and core `pyproject.toml` project metadata.
- Renamed `docs/how-to-guides/` → `docs/how-to/` per starbase's directory convention.
- Removed starbase scaffold/demo files not applicable to a library (`AGENTS.app.md`, `AGENTS.lib.md`, `.github/README.md`, `docs/release-notes/`, `starcraft/__init__.py`, `tests/*/starbase/`).
- Added new project-specific `AGENTS.md` and `CONTRIBUTING.md`.
See the merge commit message for full conflict-resolution notes.
### Validation
- `make format` ✅
- `make lint` ✅ (including new `lint-ty`, `lint-docs`)
- `make docs` ✅
- `make test-fast` — not yet run in this environment; will be verified via CI.
🤖 This PR was created by an AI agent on behalf of @lengau, following the `update-starbase` skill.
Evaluation history
| Date | Model | Scores | Action | Summary |
|---|---|---|---|---|
| stealth/space-bunny-alpha | — | closed superseded | PR #238 was closed unmerged after an external linkcheck timeout; its Starbase sync was later merged through replacement PR #252. | |
| stealth/space-bunny-alpha | — | closed stale | Starbase sync was closed unmerged after an unrelated docs linkcheck timeout to manpages.ubuntu.com; the maintainer deferred a fresh merge attempt. | |
| qwen/qwen3.6-35b-a3b | — | — | Closed without merging due to an unrelated CI network timeout. The branch updated shared tooling, CI workflows, and docs scaffolding from canonical/starbase. A fresh merge PR will be opened later to complete the update. | |
| qwen/qwen3.6-35b-a3b |
Staleness:
10
Complexity:
65
Confidence:
90
|
needs review | Merges canonical/starbase main to update shared tooling, CI, and docs scaffolding. Currently has 50 unresolved review comments, changes requested by two reviewers, and a failing lint check. | |
| qwen3.6-35b-a3b-mtp-q6 |
Staleness:
0
Complexity:
40
Confidence:
90
|
needs review | Merges canonical/starbase main into craft-archives, updating Makefile targets, docs scaffolding, lint rules, and cleaning up demo files. Currently awaiting CI validation for tests. |
Update history
| Date | Change |
|---|---|
| closed |
Related work
-
Superseded By:
canonical/craft-archives#252
(confidence 98%)
Merged Starbase update that replaced the abandoned sync.
-
Blocked By:
canonical/craft-archives#247
(confidence 95%)
Tracked the external linkcheck timeout cited when #238 was closed.
Related issues
| Issue | Project | State | Summary | Similarity |
|---|---|---|---|---|
| #236 chore(merge): update starbase (2026-06-18) | craft-platforms | closed | Starbase sync PR #236 was closed unmerged; rebuilt replacement #270 later merged Starbase into main as commit 4afcee7. | |
| #236 chore(merge): update starbase (2026-07-14) | craft-archives | closed | Closed unmerged; the Starbase update was later merged through #252 in commit 1b56643. | |
| #2895 chore(merge): update starbase (2026-09-24) | charmcraft | closed | Draft Starbase sync PR #2895 (2026-09-24) was closed unmerged; the same update was reworked as #2899 (2026-09-28), which merged as commit 8da01822 after prep PRs #2897/#2898. | |
| #237 chore(merge): update starbase (2026-07-14) | craft-archives | closed | PR #237 was closed unmerged after failing CI checks and leaving 29 review comments unresolved; no resolving commit was identified. | |
| #177 chore(merge): update starbase (2026-07-22) | debcraft | closed | Starbase merge PR #177 was closed unmerged because OSV-scanner failed; the maintainer confirmed main had the same issue and deferred a fresh merge PR. | |
| #432 chore(merge): update starbase (2026-10-08) | craft-store | closed | Starbase sync PR closed without merging due to unresolved review comments and failing copilot-setup-steps CI check. | |
| #337 chore(merge): update starbase | craft-store | merged | Merged the Starbase sync via commit 3fd7fd0, updating 43 files (+867/-690); the reported linkcheck failure was attributed to the pending howto-to-how-to docs migration. | |
| #507 chore(merge): update starbase (2026-10-20) | craft-cli | merged | Merged starbase/main sync updating CI workflows, build tooling, and docs scaffolding. Resolved 27 file conflicts, incorporated prep PRs #505 and #506, and squashed follow-up fixes into a single merge commit. | |
| #438 chore(merge): update starbase (2026-10-09) | craft-store | closed | Routine starbase dependency update PR closed due to failing CI checks and lack of review. Superseded by subsequent starbase syncs. | |
| #449 chore(merge): update starbase (2026-09-28) | imagecraft | merged | Merged in #449 via commit 545f51a, rebuilding the Starbase sync on current main and starbase/main and folding dependency, lint, docs, and CI adjustments into one merge. |