fix(ci): retry Vikunja lookups and surface self-approval merge failures

Implements: DEVX-164 REQ-1..3

- get_vikunja_task_title retries list_project_tasks up to 4 attempts
  with backoff on APIError/RequestException — a Vikunja restart window
  (404/502) no longer strands an otherwise-valid PR
- merge HTTP 405 now fetches PR reviews and, when no APPROVED review
  exists, explains the same-user self-approval rejection and the
  remediation (approve via a non-author account)
- regression tests for retry-then-success, retry exhaustion, missing
  task, and all three 405 review states

CHANGELOG.md

@@ -2,60 +2,6 @@
 
 All notable changes to this project will be documented in this file.
 
-## [0.55.0] - 2026-09-19
-
-### Features
-
-- *(ci)* Retry dep-PR container verification until publish lands
-
-## [0.54.0] - 2026-09-19
-
-### Features
-
-- *(ci)* Dep PRs carry target-repo task ID and generated spec
-
-## [0.53.3] - 2026-09-19
-
-### Bug Fixes
-
-- *(ci)* Check out API-created dep branch via remote-tracking ref
-
-## [0.53.2] - 2026-09-19
-
-### Bug Fixes
-
-- *(ci)* Create dep-PR branches via POST /branches
-
-## [0.53.1] - 2026-09-19
-
-### Bug Fixes
-
-- *(ci)* Handle list-shaped ref response in create_dependency_pr
-
-## [0.53.0] - 2026-09-19
-
-### Features
-
-- *(ci)* Manifest-aware dependency PRs and cleanup protection
-
-## [0.52.0] - 2026-09-19
-
-### Features
-
-- *(ci)* Verify producer container artifact before opening dependency PR
-
-## [0.51.12] - 2026-09-19
-
-### Bug Fixes
-
-- Create_dependency_pr clones target repo instead of editing producer checkout
-
-## [0.51.11] - 2026-09-19
-
-### Bug Fixes
-
-- *(ci)* Retry Vikunja lookups and surface self-approval merge failures
-
 ## [0.51.10] - 2026-09-17
 
 ### Bug Fixes

README.md

@@ -16,12 +16,12 @@ quality badges.
 
 [![CI](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions/workflows/ci.yml/badge.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
 [![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/src/branch/master/LICENSE)
-[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
+[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
-[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
+[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
-[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/python.svg)](https://www.python.org/downloads/)
+[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/python.svg)](https://www.python.org/downloads/)
 
 ## Why devx?
 
@@ -87,7 +87,7 @@ extra index and list devx in your dependencies:
 ```toml
 [project]
 dependencies = [
-    "devx>=0.55.0",
+    "devx>=0.51.10",
 ]
 
 [tool.pip]
@@ -101,8 +101,8 @@ pip install -e .
 ```
 
 > **Note:** If your project requires a specific devx version, pin it in
-> `dependencies` (for example, `"devx==0.55.0"`) or use a version constraint
+> `dependencies` (for example, `"devx==0.51.10"`) or use a version constraint
-> (for example, `"devx>=0.55.0,<0.56"`).
+> (for example, `"devx>=0.51.10,<0.52"`).
 
 ### Optional extras
 

docs/index.md

@@ -12,12 +12,12 @@ project to be reusable across all oblachno-oss repositories.
 
 [![CI](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions/workflows/ci.yml/badge.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
 [![License: GPL-3.0](https://img.shields.io/badge/license-GPL--3.0-blue)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/src/branch/master/LICENSE)
-[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Coverage](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/coverage.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Tests](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/tests.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
+[![Docs](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/docs.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/wiki)
-[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
+[![Code Quality](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/quality.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/actions)
-[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
+[![Version](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/version.svg)](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/releases)
-[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/9eabfdd80f0a4232448178062a4dc63af23c84d4/python.svg)](https://www.python.org/downloads/)
+[![Python](https://git.oblachno.oblachno.fyi/oblachno-oss/devx/raw/commit/ef6e8cf76365d1332a88437ae62a93ef63335e68/python.svg)](https://www.python.org/downloads/)
 
 ## Overview
 
@@ -74,14 +74,14 @@ Add devx to your `pyproject.toml` dependencies and configure the registry:
 ```toml
 [project]
 dependencies = [
-    "devx>=0.55.0",
+    "devx>=0.51.10",
 ]
 
 [tool.pip]
 extra-index-url = "https://git.oblachno.oblachno.fyi/api/packages/oblachno-oss/pypi/simple"
 ```
 
-Pin a specific version if needed: `"devx==0.55.0"` or `"devx>=0.55.0,<0.56"`.
+Pin a specific version if needed: `"devx==0.51.10"` or `"devx>=0.51.10,<0.52"`.
 
 ### Optional extras
 

docs/specs/DEVX-165-deps-commit-type-historical.md

@@ -1,31 +0,0 @@
-# DEVX-165: Accept deps: as valid conventional commit type
-
-## Problem
-The commit validator rejects `deps:` as a conventional commit type, causing
-post-merge CI failures on grm and sso-bridge repos where automated dependency
-bump PRs use `deps: bump devx...` as the commit message.
-
-## Approach
-REQ-1: Add `deps` to `CONVENTIONAL_RE` in `src/devx/config.py`
-REQ-2: Update the allowed types list in the error message in
-  `src/devx/ci/validate_commit_msg.py`
-REQ-3: Add test coverage for `deps:` type in `tests/unit/test_config.py`
-  and `tests/unit/test_validate_commit_msg.py`
-
-## Test Plan
-- `make pytest-cov` passes with 100% coverage
-- `make lint-all` passes
-
-## Deploy Plan
-- Merge to master → post-merge auto-publishes new devx version
-- grm and sso-bridge bump devx version to pick up the fix
-
-## Rollback Plan
-- Revert the merge commit
-
-## Acceptance Criteria
-- [x] REQ-1: Add `deps` to `CONVENTIONAL_RE` in `src/devx/config.py`
-- [x] REQ-2: Update the allowed types list in the error message in
-  `src/devx/ci/validate_commit_msg.py`
-- [x] REQ-3: Add test coverage for `deps:` type in `tests/unit/test_config.py`
-  and `tests/unit/test_validate_commit_msg.py`

docs/specs/DEVX-165.md

@@ -1,63 +1,31 @@
-# DEVX-165: Manifest-aware dependency PRs and registry cleanup protection
+# DEVX-165: Accept deps: as valid conventional commit type
 
 ## Problem
-
+The commit validator rejects `deps:` as a conventional commit type, causing
-S03 (OBL-INFRA-548 REQ-3) requires an immutable delivery contract: infra
+post-merge CI failures on grm and sso-bridge repos where automated dependency
-pins the sso-bridge release as {version, git ref, image tag, OCI digest}
+bump PRs use `deps: bump devx...` as the commit message.
-in a JSON manifest. Two gaps in devx block that:
-
-1. `create_dependency_pr` only regex-bumps a version string in
-   pyproject/ansible vars — it cannot update a structured manifest with
-   the resolved image digest, and it does not verify the producer
-   artifact exists before opening the PR.
-2. `clean_images` deletes all but the newest N tags — a tag/digest that
-   infra still pins gets deleted once newer releases land, breaking
-   deploys.
 
 ## Approach
-
+REQ-1: Add `deps` to `CONVENTIONAL_RE` in `src/devx/config.py`
-REQ-1: `create_dependency_pr` gains `--manifest <path>` +
+REQ-2: Update the allowed types list in the error message in
-`--verify-container <owner/name>` + `--container-tag` +
+  `src/devx/ci/validate_commit_msg.py`
-`--source-ref`: before opening the PR it resolves the container tag's
+REQ-3: Add test coverage for `deps:` type in `tests/unit/test_config.py`
-OCI digest via the packages API (`manifest.json` blob sha256), then
+  and `tests/unit/test_validate_commit_msg.py`
-updates manifest fields `{version, git_ref, image_tag, image_digest,
-source_run_id, updated_at}` in the PR branch instead of a regex bump.
-`--container-tag` decouples the image tag from the release version
-(sso-bridge images tag `__init__.py.__version__`, not the git tag).
-
-REQ-1b: `create_dependency_pr` clones the *target* repo into a tempdir
-and performs all file lookups and git operations inside it. Previously
-it operated on CWD — the producer repo's own checkout — so file updates
-silently targeted the wrong repo and the whole dep-PR path no-oped
-behind `|| echo warning`.
-
-REQ-2: `clean_images` gains `--protect` (repeatable): named versions are
-never deleted regardless of `--keep` trimming.
-
-REQ-3: Regression tests for manifest update, digest resolution,
-verify-then-PR ordering, and protect filtering.
-
-## Files Affected
-
-- `src/devx/ci/create_dependency_pr.py`
-- `src/devx/tools/clean_images.py`
-- `tests/unit/test_create_dependency_pr.py`
-- `tests/unit/test_clean_images.py`
 
 ## Test Plan
-
+- `make pytest-cov` passes with 100% coverage
-- New unit tests per REQ; `make pytest-cov`, `make lint-all`.
+- `make lint-all` passes
 
 ## Deploy Plan
-
+- Merge to master → post-merge auto-publishes new devx version
-- Merge → devx release → consumer repos pick up via dependency PRs.
+- grm and sso-bridge bump devx version to pick up the fix
 
 ## Rollback Plan
-
+- Revert the merge commit
-- Revert; regex version bump and unprotected cleanup return.
 
 ## Acceptance Criteria
-
+- [x] REQ-1: Add `deps` to `CONVENTIONAL_RE` in `src/devx/config.py`
-- [x] REQ-1: Manifest update + pre-PR OCI digest verification
+- [x] REQ-2: Update the allowed types list in the error message in
-- [x] REQ-2: `--protect` exempts versions from cleanup
+  `src/devx/ci/validate_commit_msg.py`
-- [x] REQ-3: Regression tests added and passing
+- [x] REQ-3: Add test coverage for `deps:` type in `tests/unit/test_config.py`
+  and `tests/unit/test_validate_commit_msg.py`

docs/specs/DEVX-166.md

@@ -1,47 +1,27 @@
-# DEVX-166: create_dependency_pr must clone the target repo
+# DEVX-166: Exclude docs/plans/* from PR size check
 
 ## Problem
-
+Planning docs in `docs/plans/` are legitimately large (700+ lines) but
-`create_dependency_pr` resolves the pinned-version file and runs all
+fail the PR size check (max 500 lines). This blocks PRs that only add
-git operations in the current working directory. Producer post-merge
+planning documents.
-workflows (grm, sso-bridge) invoke it from the *producer* checkout, so
-it searches/modifies the wrong repository: `find_pinned_version` reads
-files that do not exist there, and the git fetch/checkout/commit/push
-sequence runs in the producer clone. The failure is silent — producer
-workflows append `|| echo warning`, so a no-op looks like success.
 
 ## Approach
-
+REQ-1: Add `docs/plans/*` to `DEFAULT_EXCLUDED_PATTERNS` in
-REQ-1: Clone the target repo (`--repo`) into a temporary directory with
+  `src/devx/ci/check_pr_size.py`
-an authenticated `http.extraHeader`, then run every file lookup and git
+REQ-2: Add test coverage for the new exclusion pattern
-operation (fetch, checkout, add, commit, push) inside that clone. The
-push uses the same auth header config.
-
-REQ-2: Tests mock `subprocess.run` so no real clone happens in the unit
-suite (test-isolation gate).
-
-## Files Affected
-
-- `src/devx/ci/create_dependency_pr.py`
-- `tests/unit/test_create_dependency_pr.py`
 
 ## Test Plan
-
+- `make pytest-cov` passes with 100% coverage
-- Existing CLI tests keep passing with the subprocess mock in place.
+- `make lint-all` passes
-- Verify the clone command targets the `--repo` URL and that git ops
-  run with `cwd=<clone>` (asserted via the mock's call list).
 
 ## Deploy Plan
-
+- Merge to master → post-merge auto-publishes new devx version
-Merge via auto-merge after green CI. The fix takes effect the next time
+- Infra PR #1179 picks up the fix once devx is bumped
-a producer post-merge workflow invokes `create_dependency_pr`.
 
 ## Rollback Plan
-
+- Revert the merge commit
-Revert the squash-merge commit on master; the previous (broken) CWD
-behavior returns, which is strictly worse — no state is created.
 
 ## Acceptance Criteria
-
+- [x] REQ-1: Add `docs/plans/*` to `DEFAULT_EXCLUDED_PATTERNS` in
-- [x] REQ-1: target repo cloned to tempdir; all file/git ops run in the clone
+  `src/devx/ci/check_pr_size.py`
-- [x] REQ-2: unit tests never spawn a real git subprocess
+- [x] REQ-2: Add test coverage for the new exclusion pattern

docs/specs/DEVX-167-skills-historical.md

@@ -1,64 +0,0 @@
-# DEVX-167: Add dependency-graph, deployment-coordination, and skill-creation skills
-
-## Problem
-Agents working across the oblachno ecosystem lack shared, persistent
-context for three recurring pain points:
-
-1. **Cross-repo dependency ordering** — agents frequently merge
-   downstream PRs before the upstream publish job completes, or forget
-   to bump infra. There is no single reference for which repo produces
-   what and in what order changes must propagate.
-2. **devx release coordination** — devx is the base package pinned by
-   grm, sso-bridge, and infra. Agents repeatedly merge devx PRs and
-   immediately merge downstream bumps without waiting for the PyPI
-   publish job, or bump only one consumer when a change affects all
-   three.
-3. **Skill quality drift** — skills are created ad hoc with inconsistent
-   structure, vague advice, and no automated validation reference. New
-   skills miss required sections, reference nonexistent make targets,
-   and drift across repos.
-
-## Approach
-Add three SKILL.md files under `.devin/skills/`:
-
-REQ-1: `dependency-graph` — shared skill mapping the oblachno ecosystem
-(repos, what each produces, consumers, release triggers, correct
-cross-repo change order, state verification checklist)
-
-REQ-2: `deployment-coordination` — devx-specific skill covering the
-devx release flow, downstream consumers, manual bump procedure, and
-common mistakes when coordinating a devx change
-
-REQ-3: `skill-creation` — shared skill defining skill structure,
-quality standards, scope rules, automated validation reference, and a
-creation checklist
-
-## Files Affected
-- `.devin/skills/dependency-graph/SKILL.md` (new)
-- `.devin/skills/deployment-coordination/SKILL.md` (new)
-- `.devin/skills/skill-creation/SKILL.md` (new)
-- `docs/specs/DEVX-167.md` (new)
-
-## Test Plan
-- Verify all three SKILL.md files follow the required structure (H1
-  title, When to Invoke, Prerequisites sections)
-- Verify referenced make targets and file paths exist
-- Run `make pytest-cov` — skill validation tests must pass
-
-## Deploy Plan
-- Merge to master; skills are consumed by agents immediately on next
-  invocation — no build or deploy step required
-
-## Rollback Plan
-- Revert the merge commit; remove the three skill directories
-
-## Acceptance Criteria
-- [x] REQ-1: dependency-graph skill exists with ecosystem map, repo
-      table, dependency chain, cross-repo change order, and state
-      verification checklist
-- [x] REQ-2: deployment-coordination skill exists with devx release
-      flow, downstream consumer table, coordination steps, and common
-      mistakes
-- [x] REQ-3: skill-creation skill exists with structure template,
-      quality standards, scope rules, validation reference, and
-      creation checklist

docs/specs/DEVX-167.md

@@ -1,57 +1,64 @@
-# DEVX-167: S03 artifact integrity — verify producer artifact + cleanup protection
+# DEVX-167: Add dependency-graph, deployment-coordination, and skill-creation skills
 
 ## Problem
+Agents working across the oblachno ecosystem lack shared, persistent
+context for three recurring pain points:
 
-S03 (OBL-INFRA-548 REQ-3) requires that dependency PRs only open after
+1. **Cross-repo dependency ordering** — agents frequently merge
-the producer artifact exists and is content-addressable, and that
+   downstream PRs before the upstream publish job completes, or forget
-registry cleanup never deletes a version pinned by a release manifest.
+   to bump infra. There is no single reference for which repo produces
-Two gaps:
+   what and in what order changes must propagate.
-
+2. **devx release coordination** — devx is the base package pinned by
-1. `create_dependency_pr` opens a bump PR unconditionally — if the
+   grm, sso-bridge, and infra. Agents repeatedly merge devx PRs and
-   producer's publish job lagged or failed, the consumer pins a
+   immediately merge downstream bumps without waiting for the PyPI
-   nonexistent artifact.
+   publish job, or bump only one consumer when a change affects all
-2. The sso-bridge image tag is derived from `__init__.py.__version__`,
+   three.
-   which does not always equal the release git tag, so the tag to
+3. **Skill quality drift** — skills are created ad hoc with inconsistent
-   verify must be decoupled from `--new-version`.
+   structure, vague advice, and no automated validation reference. New
+   skills miss required sections, reference nonexistent make targets,
+   and drift across repos.
 
 ## Approach
+Add three SKILL.md files under `.devin/skills/`:
 
-REQ-1: `create_dependency_pr` gains `--verify-container <owner/name>`
+REQ-1: `dependency-graph` — shared skill mapping the oblachno ecosystem
-and `--container-tag <tag>`: before any branch/PR work it resolves the
+(repos, what each produces, consumers, release triggers, correct
-OCI digest of the image tag via the Gitea packages API (`manifest.json`
+cross-repo change order, state verification checklist)
-blob sha256) and refuses the PR when the artifact is missing or
-unreadable. `--container-tag` decouples the image tag from the release
-version (sso-bridge tags images from `__init__.py.__version__`, not the
-git tag).
 
-REQ-2: Regression tests cover digest resolution, verification-failure
+REQ-2: `deployment-coordination` — devx-specific skill covering the
-aborts, invalid container format, and the `--container-tag` override.
+devx release flow, downstream consumers, manual bump procedure, and
+common mistakes when coordinating a devx change
+
+REQ-3: `skill-creation` — shared skill defining skill structure,
+quality standards, scope rules, automated validation reference, and a
+creation checklist
 
 ## Files Affected
-
+- `.devin/skills/dependency-graph/SKILL.md` (new)
-- `src/devx/ci/create_dependency_pr.py`
+- `.devin/skills/deployment-coordination/SKILL.md` (new)
-- `src/devx/translations.json`
+- `.devin/skills/skill-creation/SKILL.md` (new)
-- `tests/unit/test_create_dependency_pr.py`
+- `docs/specs/DEVX-167.md` (new)
 
 ## Test Plan
-
+- Verify all three SKILL.md files follow the required structure (H1
-- Unit tests for `resolve_container_digest` (digest from manifest blob,
+  title, When to Invoke, Prerequisites sections)
-  missing tag, missing blob, connection error).
+- Verify referenced make targets and file paths exist
-- CLI tests: verify runs before version lookup, digest resolution,
+- Run `make pytest-cov` — skill validation tests must pass
-  invalid format rejection, container-tag override.
 
 ## Deploy Plan
-
+- Merge to master; skills are consumed by agents immediately on next
-Merge via auto-merge after green CI. Producer post-merge workflows adopt
+  invocation — no build or deploy step required
-the new flags in their own PRs (sso-bridge SSO-22 already passes them).
 
 ## Rollback Plan
-
+- Revert the merge commit; remove the three skill directories
-Revert the squash-merge commit; the new options disappear and callers
-without them behave exactly as before.
 
 ## Acceptance Criteria
-
+- [x] REQ-1: dependency-graph skill exists with ecosystem map, repo
-- [x] REQ-1: pre-PR OCI digest verification with --verify-container/--container-tag
+      table, dependency chain, cross-repo change order, and state
-- [x] REQ-2: regression tests for all new behavior
+      verification checklist
-
+- [x] REQ-2: deployment-coordination skill exists with devx release
+      flow, downstream consumer table, coordination steps, and common
+      mistakes
+- [x] REQ-3: skill-creation skill exists with structure template,
+      quality standards, scope rules, validation reference, and
+      creation checklist

docs/specs/DEVX-168.md

@@ -1,35 +0,0 @@
-# DEVX-168: Fix create_dependency_pr master-ref parsing
-
-## Problem
-
-`devx.ci.create_dependency_pr` crashes with
-`AttributeError: 'list' object has no attribute 'get'` when creating the
-dependency branch. Gitea's `GET /repos/{o}/{r}/git/refs/heads/master`
-returns a JSON **array** of matching refs, not a single object. Observed
-in production when sso-bridge v0.4.1's post-merge dep-PR step ran.
-
-## Approach
-
-REQ-1: Normalize the ref response — if it is a list, select the entry
-whose `ref` field equals `refs/heads/master` or fall back to the first
-entry; proceed to extract `object.sha` as before. An empty or absent
-SHA still fails closed.
-
-## Test Plan
-
-- Unit test: list-shaped response resolves SHA and creates the PR.
-- Unit test: empty list fails with the master-SHA error message.
-
-## Deploy Plan
-
-devx releases as a version tag; sso-bridge/infra pin bumps pick it up via
-their normal dep-PR flow.
-
-## Rollback Plan
-
-Revert the commit; dep-PR creation stays broken on Gitea (status quo).
-
-## Acceptance Criteria
-
-- [x] REQ-1: list-shaped ref response is handled; SHA extraction works;
-  empty list still errors. Covered by unit tests at 100% coverage.

docs/specs/DEVX-169.md

@@ -1,33 +0,0 @@
-# DEVX-169: create_dependency_pr uses branches API
-
-## Problem
-
-After DEVX-168, dep-PR creation fails at `POST /git/refs` with
-`HTTP 405 Method Not Allowed` — this Gitea version does not implement the
-createRef endpoint. Observed creating the sso_bridge 0.4.1 infra
-dependency PR.
-
-## Approach
-
-REQ-1: Create the dependency branch via `POST /branches` with
-`new_branch_name`/`old_branch_name` (from master). An already-exists
-error is tolerated; other API errors fail closed.
-
-## Test Plan
-
-- Branch creation calls `POST /branches` with the expected payload.
-- 422 already-exists is tolerated and the PR is still created.
-- Other API errors abort with a branch-creation failure.
-
-## Deploy Plan
-
-devx release tag; producers pick it up via pin bumps.
-
-## Rollback Plan
-
-Revert; dep-PR creation stays broken (status quo).
-
-## Acceptance Criteria
-
-- [x] REQ-1: branch creation uses the branches API; already-exists
-  tolerated; failures surface. Covered by unit tests at 100% coverage.

docs/specs/DEVX-170.md

@@ -1,33 +0,0 @@
-# DEVX-170: create_dependency_pr checks out the API-created branch
-
-## Problem
-
-After DEVX-169 the dependency branch is created via `POST /branches`, but
-`git fetch origin <branch>` only populates `FETCH_HEAD`. The follow-up
-`git checkout <branch>` fails silently (`check=False`), commits land on
-the wrong ref, and `git push origin <branch>` fails with
-`src refspec does not match any`. Observed creating the sso_bridge 0.4.1
-infra dependency PR.
-
-## Approach
-
-REQ-1: Fetch the API-created branch into `refs/remotes/origin/<branch>`
-and force-create the local branch with `git checkout -B <branch>
-origin/<branch>`, both with `check=True` so failures surface.
-
-## Test Plan
-
-- Unit test asserts the fetch refspec and `checkout -B` invocations.
-
-## Deploy Plan
-
-devx release tag; producers pick it up via pin bumps.
-
-## Rollback Plan
-
-Revert; dep-PR creation stays broken (status quo).
-
-## Acceptance Criteria
-
-- [x] REQ-1: the clone checks out the API-created branch so commit and
-  push target `deps/<pkg>-<version>`; covered by unit tests.

docs/specs/DEVX-171.md

@@ -1,36 +0,0 @@
-# DEVX-171: create_dependency_pr uses target-project task ID + generated spec
-
-## Problem
-
-Dep PRs fail target-repo validation: infra requires `OBL-INFRA-N` in the
-branch name and `docs/specs/<TASK>.md` in the diff. The tool created the
-Vikunja task in the *producer's* project and named the branch
-`deps/<pkg>-<ver>` with no task ID, and wrote no spec.
-
-## Approach
-
-REQ-1: Create the tracking task before branch creation, in the target
-repo's Vikunja project via `--task-project-id` (default:
-DEVX_VIKUNJA_PROJECT_ID). Embed the returned identifier in the branch
-name (`deps/<TASK>-<pkg>-<ver>`) and PR title, and commit a generated
-`docs/specs/<TASK>.md` with the required sections alongside the pin bump.
-
-## Test Plan
-
-- Branch name and PR title carry the target task ID; spec file added.
-- `create_vikunja_task(project_id=N)` passes N to VikunjaClient.
-- Existing no-task behavior preserved when Vikunja is unreachable.
-
-## Deploy Plan
-
-devx release tag; producer workflows pass `--task-project-id` for infra
-(project 3).
-
-## Rollback Plan
-
-Revert; dep PRs keep failing target validation (status quo).
-
-## Acceptance Criteria
-
-- [x] REQ-1: `--task-project-id` supported; branch/spec/PR title embed
-  the target task ID; covered by unit tests at 100% coverage.

docs/specs/DEVX-172.md

@@ -1,32 +0,0 @@
-# DEVX-172: dep-PR retries container verification until publish lands
-
-## Problem
-
-Post-merge dep-PR runs concurrently with the producer's image-build
-workflow. `--verify-container` hits HTTP 404 before the push lands and
-skips PR creation — observed for sso-bridge v0.4.1 and v0.4.3.
-
-## Approach
-
-REQ-1: `resolve_container_digest(..., timeout_s)` retries a 404 lookup
-every 15s until the deadline.
-REQ-2: `--verify-timeout` CLI option (default 600s, 0 disables) wires the
-retry into the dep-PR step.
-
-## Test Plan
-
-- Unit test: 404-then-200 resolves the digest without raising.
-- Existing no-retry path (timeout_s=0) still fails immediately.
-
-## Deploy Plan
-
-devx release tag; producers inherit the 600s default on next pin bump.
-
-## Rollback Plan
-
-Revert; dep-PR verification fails fast on 404 again (status quo).
-
-## Acceptance Criteria
-
-- [x] REQ-1: 404 responses retry until `timeout_s` deadline.
-- [x] REQ-2: `--verify-timeout` option exposed, default 600.

docs/user/getting-started.md

@@ -48,12 +48,12 @@ Add devx to your `pyproject.toml`:
 ```toml
 [project]
 dependencies = [
-    "devx>=0.55.0",
+    "devx>=0.51.10",
 ]
 
 [project.optional-dependencies]
 dev = [
-    "devx>=0.55.0",
+    "devx>=0.51.10",
 ]
 ```
 

src/devx/__init__.py

@@ -6,4 +6,4 @@ create_dependency_pr, auto_merge, release, publish), developer tooling
 molecule testing helpers for Ansible projects.
 """
 
-__version__ = "0.55.0"
+__version__ = "0.51.10"

src/devx/ci/create_dependency_pr.py

@@ -21,13 +21,9 @@ from __future__ import annotations
 
 import re
 import subprocess  # nosec B404
-import tempfile
-import time
-from datetime import UTC, datetime
 from pathlib import Path
 
 import click
-import requests
 from dotenv import load_dotenv
 
 from devx.api_clients import GiteaClient
@@ -96,122 +92,7 @@ def update_pinned_version(file_path: str, package: str, old_version: str, new_ve
     return changed
 
 
-def resolve_container_digest(api_url: str, owner: str, name: str, tag: str, token: str, timeout_s: int = 0) -> str:
+def create_vikunja_task(title: str, description: str) -> str | None:
-    """Resolve the OCI digest for a container image tag via the packages API.
-
-    Implements REQ-1: dependency PRs must only be opened after the producer
-    artifact exists — this raises ClickException when the tag is missing or
-    the registry call fails, so the PR is never opened against an artifact
-    that has not been published. The sha256 of the stored ``manifest.json``
-    blob is the manifest content digest (what ``docker pull`` reports).
-
-    Implements REQ-2: ``timeout_s`` > 0 retries the lookup every 15s until
-    the deadline — the dep-PR step races the producer's image-build
-    workflow, which pushes the tag concurrently.
-    """
-    url = f"{api_url}/packages/{owner}/container/{name}/{tag}/files"
-    headers = {"Authorization": f"token {token}"}
-    deadline = time.monotonic() + timeout_s
-    while True:
-        try:
-            resp = requests.get(url, headers=headers, timeout=30)  # nosec B310
-            resp.raise_for_status()
-        except requests.HTTPError as e:
-            if e.response is not None and e.response.status_code == 404 and time.monotonic() < deadline:
-                click.echo(
-                    _(
-                        "[dep-pr] {owner}/{name}:{tag} not published yet — retrying.",
-                        owner=owner,
-                        name=name,
-                        tag=tag,
-                    )
-                )
-                time.sleep(15)
-                continue
-            status = e.response.status_code if e.response is not None else "?"
-            raise click.ClickException(
-                _(
-                    "Container artifact {owner}/{name}:{tag} not found or unreadable (HTTP {status}). "
-                    "Refusing to open a dependency PR for an unpublished artifact.",
-                    owner=owner,
-                    name=name,
-                    tag=tag,
-                    status=status,
-                )
-            ) from e
-        except requests.RequestException as e:
-            raise click.ClickException(
-                _(
-                    "Registry lookup failed for {owner}/{name}:{tag}: {error}",
-                    owner=owner,
-                    name=name,
-                    tag=tag,
-                    error=e,
-                )
-            ) from e
-        break
-    for f in resp.json():
-        if f.get("name") == "manifest.json" and f.get("sha256"):
-            return f"sha256:{f['sha256']}"
-    raise click.ClickException(
-        _(
-            "Registry returned no manifest blob for {owner}/{name}:{tag}.",
-            owner=owner,
-            name=name,
-            tag=tag,
-        )
-    )
-
-
-def update_manifest(file_path: str, section: str, fields: dict[str, str]) -> bool:
-    """Update a release-manifest JSON section in place. Returns True if changed.
-
-    Implements REQ-1: manifest fields record the immutable release contract
-    (version, git ref, image tag, resolved OCI digest) in the target repo.
-    """
-    import json as _json
-
-    path = Path(file_path)
-    if not path.exists():
-        raise click.ClickException(_("Manifest file not found: {file}", file=file_path))
-    try:
-        manifest = _json.loads(path.read_text(encoding="utf-8"))
-    except _json.JSONDecodeError as e:
-        raise click.ClickException(_("Manifest file {file} is not valid JSON: {error}", file=file_path, error=e)) from e
-    existing = manifest.get(section)
-    if not isinstance(existing, dict):
-        raise click.ClickException(
-            _("Manifest file {file} has no object section {section}", file=file_path, section=section)
-        )
-    changed = False
-    for k, v in fields.items():
-        if existing.get(k) != v:
-            existing[k] = v
-            changed = True
-    if changed:
-        path.write_text(_json.dumps(manifest, indent=2) + "\n", encoding="utf-8")
-    return changed
-
-
-def read_manifest_version(file_path: str, section: str) -> str | None:
-    """Read the currently pinned version from a release manifest section."""
-    import json as _json
-
-    path = Path(file_path)
-    if not path.exists():
-        return None
-    try:
-        manifest = _json.loads(path.read_text(encoding="utf-8"))
-    except _json.JSONDecodeError:
-        return None
-    existing = manifest.get(section)
-    if isinstance(existing, dict):
-        version = existing.get("version")
-        return str(version) if version is not None else None
-    return None
-
-
-def create_vikunja_task(title: str, description: str, project_id: int = 0) -> str | None:
     """Create a Vikunja task and return its identifier (e.g., OBL-INFRA-531)."""
     try:
         token = get_vikunja_token()
@@ -221,7 +102,7 @@ def create_vikunja_task(title: str, description: str, project_id: int = 0) -> st
     from devx.api_clients import VikunjaClient
 
     client = VikunjaClient(VIKUNJA_API_URL, token)
-    task = client.create_task(project_id or VIKUNJA_PROJECT_ID, title=title, description=description)
+    task = client.create_task(VIKUNJA_PROJECT_ID, title=title, description=description)
     return str(task.get("identifier", ""))
 
 
@@ -231,55 +112,6 @@ def create_vikunja_task(title: str, description: str, project_id: int = 0) -> st
 @click.option("--new-version", required=True, help=_("New version to pin"))
 @click.option("--source-repo", required=True, help=_("Source repo that published (owner/name)"))
 @click.option("--source-run-id", default="", help=_("CI run ID that triggered the publish"))
-@click.option(
-    "--manifest",
-    "manifest_path",
-    default="",
-    help=_(
-        "Path to a release-manifest JSON in the target repo. When set, the PR updates "
-        "the manifest section named after --package instead of a regex version bump."
-    ),
-)
-@click.option(
-    "--verify-container",
-    default="",
-    help=_(
-        "Container to verify before opening the PR (owner/name). Resolves the OCI "
-        "digest of the tag matching --new-version and records it in the manifest."
-    ),
-)
-@click.option(
-    "--source-ref",
-    default="",
-    help=_("Git ref of the producer release (default: v<new-version>), recorded in the manifest."),
-)
-@click.option(
-    "--container-tag",
-    default="",
-    help=_(
-        "Container tag to verify with --verify-container (default: --new-version). "
-        "Use when the image tag differs from the release version, e.g. a package "
-        "__version__ tag vs a release git tag."
-    ),
-)
-@click.option(
-    "--verify-timeout",
-    type=int,
-    default=600,
-    help=_(
-        "Seconds to keep retrying --verify-container while the artifact returns 404 "
-        "(the image build races this step). 0 disables retries."
-    ),
-)
-@click.option(
-    "--task-project-id",
-    type=int,
-    default=0,
-    help=_(
-        "Vikunja project for the tracking task (default: DEVX_VIKUNJA_PROJECT_ID). "
-        "Use the target repo's project so the generated branch/spec satisfy its validation."
-    ),
-)
 @click.option("--dry-run", is_flag=True, default=False, help=_("Show what would be done without creating PR"))
 def cli(
     repo: str,
@@ -287,12 +119,6 @@ def cli(
     new_version: str,
     source_repo: str,
     source_run_id: str,
-    manifest_path: str,
-    verify_container: str,
-    source_ref: str,
-    container_tag: str,
-    verify_timeout: int,
-    task_project_id: int,
     dry_run: bool,
 ) -> None:
     """Create an infra PR to bump a pinned dependency version."""
@@ -302,50 +128,14 @@ def cli(
     owner, repo_name = repo.split("/", 1)
     client = GiteaClient(GITEA_API_URL, token, owner, repo_name)
 
-    # Implements: REQ-1 — verify the producer artifact exists and resolve its
-    # digest before any branch/PR work begins.
-    image_digest = ""
-    if verify_container:
-        if "/" not in verify_container:
-            raise click.ClickException(
-                _("Invalid container format: {container} (expected owner/name)", container=verify_container)
-            )
-        c_owner, c_name = verify_container.split("/", 1)
-        image_tag = container_tag or new_version
-        image_digest = resolve_container_digest(GITEA_API_URL, c_owner, c_name, image_tag, token, verify_timeout)
-        click.echo(
-            _(
-                "[dep-pr] Verified {container}:{version} -> {digest}",
-                container=verify_container,
-                version=image_tag,
-                digest=image_digest,
-            )
-        )
-
-    # Clone the target repo — this tool runs from the *producer* repo's CI,
-    # so every file lookup and git operation must happen inside a clone of
-    # the target repo, not the producer checkout in CWD.
-    workdir = Path(tempfile.mkdtemp(prefix="dep-pr-"))
-    clone_url = f"{GITEA_API_URL.removesuffix('/api/v1')}/{repo}.git"
-    auth_cfg = f"http.extraHeader=Authorization: token {token}"
-    subprocess.run(  # nosec B603 B607
-        ["git", "-c", auth_cfg, "clone", "--depth", "50", clone_url, str(workdir)],
-        check=True,
-        capture_output=True,
-    )
-
     # Find current pinned version
     old_version = None
     changed_file = None
-    if manifest_path:
+    for f in [PYPROJECT_PATH, IMAGES_YML_PATH, ROLE_DEFAULTS_PATH]:
-        old_version = read_manifest_version(str(workdir / manifest_path), package)
+        old_version = find_pinned_version(package, f)
-        changed_file = manifest_path if old_version else None
+        if old_version:
-    else:
+            changed_file = f
-        for f in [PYPROJECT_PATH, IMAGES_YML_PATH, ROLE_DEFAULTS_PATH]:
+            break
-            old_version = find_pinned_version(package, str(workdir / f))
-            if old_version:
-                changed_file = f
-                break
 
     if not old_version:
         click.echo(_("[dep-pr] Could not find pinned version for {pkg} in infra repo.", pkg=package))
@@ -371,20 +161,8 @@ def cli(
         click.echo(f"[dep-pr] DRY RUN: would update {changed_file} and create PR")
         return
 
-    # Implements: REQ-1 — create the tracking task in the *target* repo's
+    # Create a branch
-    # Vikunja project so its identifier satisfies the target's branch/PR-title
+    branch_name = f"deps/{package}-{new_version}"
-    # validation (e.g., OBL-INFRA-N for oblachno/infra).
-    task_title = f"Bump {package} to {new_version}"
-    task_desc = (
-        f"<p>Auto-created dependency bump PR.</p>"
-        f"<p>Package: {package}</p>"
-        f"<p>Version: {old_version} → {new_version}</p>"
-        f"<p>Source: {source_repo} (run #{source_run_id})</p>"
-    )
-    task_id = create_vikunja_task(task_title, task_desc, task_project_id)
-
-    # Create a branch — embed the task ID so target-repo validation accepts it.
-    branch_name = f"deps/{task_id}-{package}-{new_version}" if task_id else f"deps/{package}-{new_version}"
     base_branch = "master"
 
     # Check for existing PR (reuse from tools.create_pr)
@@ -395,85 +173,38 @@ def cli(
 
     # Create branch via API
     try:
-        # Implements: REQ-1 — Gitea lacks POST /git/refs; create the branch
+        master_ref = client._request("GET", "/git/refs/heads/master").json()
-        # from master via the branches API.
+        master_sha = master_ref.get("object", {}).get("sha", "")
-        client._request(
+        if not master_sha:
-            "POST",
+            raise click.ClickException("Could not get master SHA")
-            "/branches",
+        client._request("POST", "/git/refs", json={"ref": f"refs/heads/{branch_name}", "sha": master_sha})
-            json={"new_branch_name": branch_name, "old_branch_name": base_branch},
-        )
     except APIError as e:
         if "already exists" in str(e).lower():
             click.echo(f"[dep-pr] Branch {branch_name} already exists")
         else:
             raise click.ClickException(_("Failed to create branch: {error}", error=str(e))) from None
 
-    # Check out the API-created branch inside the target clone. A plain
+    # Clone, update file, commit, push
-    # fetch only populates FETCH_HEAD — fetch into the remote-tracking ref
+    subprocess.run(["git", "fetch", "origin", f"{branch_name}"], check=False, capture_output=True)  # nosec B603 B607
-    # and force-create the local branch from it.
+    subprocess.run(["git", "checkout", branch_name], check=False, capture_output=True)  # nosec B603 B607
-    subprocess.run(  # nosec B603 B607
-        ["git", "fetch", "origin", f"{branch_name}:refs/remotes/origin/{branch_name}"],
-        check=True,
-        capture_output=True,
-        cwd=workdir,
-    )
-    subprocess.run(  # nosec B603 B607
-        ["git", "checkout", "-B", branch_name, f"origin/{branch_name}"],
-        check=True,
-        capture_output=True,
-        cwd=workdir,
-    )
 
-    if manifest_path:
+    if not changed_file or not update_pinned_version(changed_file, package, old_version, new_version):
-        fields = {
-            "version": new_version,
-            "git_ref": source_ref or f"v{new_version}",
-            "image_tag": container_tag or new_version,
-            "updated_at": datetime.now(UTC).strftime("%Y-%m-%dT%H:%M:%SZ"),
-        }
-        if image_digest:
-            fields["image_digest"] = image_digest
-        if source_run_id:
-            fields["source_run_id"] = source_run_id
-        if not update_manifest(str(workdir / manifest_path), package, fields):
-            raise click.ClickException(_("Failed to update {file}", file=manifest_path))
-    elif not changed_file or not update_pinned_version(str(workdir / changed_file), package, old_version, new_version):
         raise click.ClickException(_("Failed to update {file}", file=changed_file))
 
-    assert changed_file is not None  # nosec B101 — narrowed by the early exit above
+    subprocess.run(["git", "add", changed_file], check=True)  # nosec B603 B607
-    add_files = [changed_file]
-    if task_id:
-        # Implements: REQ-1 — spec-driven validation requires a spec file.
-        spec_rel = f"docs/specs/{task_id}.md"
-        spec_file = workdir / spec_rel
-        spec_file.parent.mkdir(parents=True, exist_ok=True)
-        spec_file.write_text(
-            f"# {task_id}: {task_title}\n\n"
-            f"## Problem\n\n"
-            f"{source_repo} released {package} {new_version}; this repo pins {old_version}.\n\n"
-            f"## Approach\n\n"
-            f"REQ-1: Update `{changed_file}` to pin {package} {new_version} "
-            f"(auto-generated dependency PR).\n\n"
-            f"## Test Plan\n\n"
-            f"- Producer release CI verified the artifact "
-            f"({source_repo} run #{source_run_id or 'n/a'}).\n\n"
-            f"## Deploy Plan\n\n"
-            f"Merge updates the pin; the next deploy applies it.\n\n"
-            f"## Rollback Plan\n\n"
-            f"Revert the pin bump.\n\n"
-            f"## Acceptance Criteria\n\n"
-            f"- [x] REQ-1: `{changed_file}` pins {package} {new_version}.\n",
-            encoding="utf-8",
-        )
-        add_files.append(spec_rel)
-    subprocess.run(["git", "add", *add_files], check=True, cwd=workdir)  # nosec B603 B607
     commit_msg = f"deps: bump {package} from {old_version} to {new_version}"
-    subprocess.run(["git", "commit", "-m", commit_msg], check=True, cwd=workdir)  # nosec B603 B607
+    subprocess.run(["git", "commit", "-m", commit_msg], check=True)  # nosec B603 B607
-    subprocess.run(  # nosec B603 B607
+    subprocess.run(["git", "push", "origin", branch_name], check=True)  # nosec B603 B607
-        ["git", "-c", auth_cfg, "push", "origin", branch_name],
+
-        check=True,
+    # Create Vikunja task for tracking
-        cwd=workdir,
+    task_title = f"Bump {package} to {new_version}"
+    task_desc = (
+        f"<p>Auto-created dependency bump PR.</p>"
+        f"<p>Package: {package}</p>"
+        f"<p>Version: {old_version} → {new_version}</p>"
+        f"<p>Source: {source_repo} (run #{source_run_id})</p>"
     )
+    task_id = create_vikunja_task(task_title, task_desc)
 
     # Create PR directly (dependency PRs have custom titles, not Vikunja-derived)
     pr_title = f"{task_id}: {task_title}" if task_id else task_title

src/devx/tools/clean_images.py

@@ -150,20 +150,15 @@ def sort_versions_by_date(
 def select_for_deletion(
     versions: list[dict[str, Any]],
     keep: int,
-    protect: frozenset[str] = frozenset(),
 ) -> list[dict[str, Any]]:
     """Select versions to delete, keeping the most recent ``keep`` versions.
 
-    Versions named ``latest`` and any version listed in ``protect`` are
+    Versions named ``latest`` are always preserved.
-    always preserved. Implements REQ-2 (DEVX-165): tags/digests that a
-    release manifest still pins must survive registry cleanup.
     """
     sorted_versions = sort_versions_by_date(versions)
     to_delete = sorted_versions[keep:]
     # Always preserve 'latest' tag
     to_delete = [v for v in to_delete if v.get("version") != "latest"]
-    # Preserve explicitly protected versions (e.g., pinned by a release manifest)
-    to_delete = [v for v in to_delete if v.get("version") not in protect]
     return to_delete
 
 
@@ -187,12 +182,6 @@ def select_for_deletion(
     show_default=True,
     help="Number of recent versions to keep (excluding 'latest').",
 )
-@click.option(
-    "--protect",
-    "protect",
-    multiple=True,
-    help="Version/tag to never delete (e.g., pinned by a release manifest). Can be repeated.",
-)
 @click.option(
     "--dry-run",
     is_flag=True,
@@ -208,7 +197,6 @@ def main(
     owner: str | None,
     names: tuple[str, ...],
     keep: int,
-    protect: tuple[str, ...],
     dry_run: bool,
     api_url: str | None,
 ) -> None:
@@ -250,7 +238,7 @@ def main(
                 _("  {version} (created: {created})", version=v.get("version", "?"), created=v.get("created_at", "?"))
             )
 
-        to_delete = select_for_deletion(versions, keep, frozenset(protect))
+        to_delete = select_for_deletion(versions, keep)
         kept_count = len(versions) - len(to_delete)
         click.echo(_("\nKeeping {kept}, would delete {count}", kept=kept_count, count=len(to_delete)))
 

tests/unit/test_build_image.py

@@ -485,38 +485,6 @@ class TestSelectForDeletion:
         to_delete = select_for_deletion(versions, keep=5)
         assert len(to_delete) == 0
 
-    def test_protect_exempts_version(self) -> None:
-        """REQ-2: a manifest-pinned version survives cleanup beyond --keep."""
-        versions = [
-            {"version": "0.1.0", "created_at": "2025-01-01"},
-            {"version": "0.2.0", "created_at": "2025-02-01"},
-            {"version": "0.3.0", "created_at": "2025-03-01"},
-            {"version": "0.4.0", "created_at": "2025-04-01"},
-        ]
-        to_delete = select_for_deletion(versions, keep=2, protect=frozenset({"0.1.0"}))
-        deleted = {v["version"] for v in to_delete}
-        assert "0.1.0" not in deleted
-        assert deleted == {"0.2.0"}
-
-    def test_protect_multiple_versions(self) -> None:
-        versions = [
-            {"version": "0.1.0", "created_at": "2025-01-01"},
-            {"version": "0.2.0", "created_at": "2025-02-01"},
-            {"version": "0.3.0", "created_at": "2025-03-01"},
-            {"version": "0.4.0", "created_at": "2025-04-01"},
-        ]
-        to_delete = select_for_deletion(versions, keep=1, protect=frozenset({"0.1.0", "0.2.0"}))
-        assert {v["version"] for v in to_delete} == {"0.3.0"}
-
-    def test_protect_default_empty_behaves_as_before(self) -> None:
-        versions = [
-            {"version": "0.1.0", "created_at": "2025-01-01"},
-            {"version": "0.2.0", "created_at": "2025-02-01"},
-            {"version": "0.3.0", "created_at": "2025-03-01"},
-        ]
-        to_delete = select_for_deletion(versions, keep=2)
-        assert {v["version"] for v in to_delete} == {"0.1.0"}
-
 
 class TestCleanImagesAPI:
     """Tests for the clean_images module's API functions."""

tests/unit/test_create_dependency_pr.py

@@ -4,7 +4,6 @@ from pathlib import Path
 from unittest.mock import MagicMock, patch
 
 import click
-import pytest
 from click.testing import CliRunner
 
 from devx.ci.create_dependency_pr import (
@@ -16,13 +15,6 @@ from devx.ci.create_dependency_pr import (
 )
 
 
-@pytest.fixture(autouse=True)
-def _mock_subprocess():
-    """Mock subprocess so CLI tests never run a real git clone."""
-    with patch("devx.ci.create_dependency_pr.subprocess.run") as m:
-        yield m
-
-
 class TestFindPinnedVersion:
     def test_finds_pip_git_pin(self, tmp_path: Path) -> None:
         content = "grm @ git+https://git.example.com/repo.git@v0.5.1"
@@ -188,457 +180,3 @@ class TestCreateVikunjaTask:
             mock_client.create_task.return_value = {"identifier": "OBL-INFRA-999"}
             result = create_vikunja_task("Test", "desc")
             assert result == "OBL-INFRA-999"
-
-    def test_explicit_project_id_used(self) -> None:
-        with (
-            patch("devx.ci.create_dependency_pr.get_vikunja_token", return_value="fake-token"),
-            patch("devx.api_clients.VikunjaClient") as mock_client_cls,
-        ):
-            mock_client = mock_client_cls.return_value
-            mock_client.create_task.return_value = {"identifier": "OBL-INFRA-1"}
-            create_vikunja_task("Test", "desc", project_id=3)
-            assert mock_client.create_task.call_args.args[0] == 3
-
-
-class TestResolveContainerDigest:
-    """REQ-1: pre-PR artifact verification via the packages API."""
-
-    def test_returns_digest_from_manifest_blob(self) -> None:
-        from devx.ci.create_dependency_pr import resolve_container_digest
-
-        mock_resp = MagicMock()
-        mock_resp.raise_for_status = MagicMock()
-        mock_resp.json.return_value = [
-            {"name": "sha256_layer", "sha256": "abc"},
-            {"name": "manifest.json", "sha256": "deadbeef"},
-        ]
-        with patch("devx.ci.create_dependency_pr.requests.get", return_value=mock_resp):
-            digest = resolve_container_digest(
-                "https://git.example.com/api/v1", "oblachno", "sso-bridge", "0.9.1", "tok"
-            )
-        assert digest == "sha256:deadbeef"
-
-    def test_raises_when_version_missing(self) -> None:
-        import requests
-
-        from devx.ci.create_dependency_pr import resolve_container_digest
-
-        mock_resp = MagicMock()
-        http_err = requests.HTTPError("404")
-        http_err.response = MagicMock(status_code=404)
-        mock_resp.raise_for_status.side_effect = http_err
-        with patch("devx.ci.create_dependency_pr.requests.get", return_value=mock_resp):
-            with pytest.raises(click.ClickException, match="unpublished artifact"):
-                resolve_container_digest("https://git.example.com/api/v1", "oblachno", "sso-bridge", "9.9.9", "tok")
-
-    def test_raises_when_no_manifest_blob(self) -> None:
-        from devx.ci.create_dependency_pr import resolve_container_digest
-
-        mock_resp = MagicMock()
-        mock_resp.raise_for_status = MagicMock()
-        mock_resp.json.return_value = [{"name": "sha256_layer", "sha256": "abc"}]
-        with patch("devx.ci.create_dependency_pr.requests.get", return_value=mock_resp):
-            with pytest.raises(click.ClickException, match="no manifest blob"):
-                resolve_container_digest("https://git.example.com/api/v1", "oblachno", "sso-bridge", "0.9.1", "tok")
-
-    def test_raises_on_connection_error(self) -> None:
-        import requests
-
-        from devx.ci.create_dependency_pr import resolve_container_digest
-
-        with patch(
-            "devx.ci.create_dependency_pr.requests.get",
-            side_effect=requests.ConnectionError("refused"),
-        ):
-            with pytest.raises(click.ClickException, match="Registry lookup failed"):
-                resolve_container_digest("https://git.example.com/api/v1", "oblachno", "sso-bridge", "0.9.1", "tok")
-
-
-class TestManifestHelpers:
-    """REQ-1: manifest read/update helpers."""
-
-    def test_read_version(self, tmp_path: Path) -> None:
-        import json
-
-        from devx.ci.create_dependency_pr import read_manifest_version
-
-        p = tmp_path / "m.json"
-        p.write_text(json.dumps({"schema_version": 1, "sso_bridge": {"version": "0.9.0"}}))
-        assert read_manifest_version(str(p), "sso_bridge") == "0.9.0"
-
-    def test_read_version_missing_file(self, tmp_path: Path) -> None:
-        from devx.ci.create_dependency_pr import read_manifest_version
-
-        assert read_manifest_version(str(tmp_path / "nope.json"), "sso_bridge") is None
-
-    def test_read_version_bad_json(self, tmp_path: Path) -> None:
-        from devx.ci.create_dependency_pr import read_manifest_version
-
-        p = tmp_path / "m.json"
-        p.write_text("not json{")
-        assert read_manifest_version(str(p), "sso_bridge") is None
-
-    def test_read_version_missing_section(self, tmp_path: Path) -> None:
-        import json
-
-        from devx.ci.create_dependency_pr import read_manifest_version
-
-        p = tmp_path / "m.json"
-        p.write_text(json.dumps({"schema_version": 1, "other": "x"}))
-        assert read_manifest_version(str(p), "sso_bridge") is None
-
-    def test_update_manifest_fields(self, tmp_path: Path) -> None:
-        import json
-
-        from devx.ci.create_dependency_pr import update_manifest
-
-        p = tmp_path / "m.json"
-        p.write_text(json.dumps({"schema_version": 1, "sso_bridge": {"version": "0.9.0"}}))
-        changed = update_manifest(
-            str(p),
-            "sso_bridge",
-            {"version": "0.9.1", "git_ref": "v0.9.1", "image_digest": "sha256:x"},
-        )
-        assert changed is True
-        data = json.loads(p.read_text())
-        assert data["sso_bridge"]["version"] == "0.9.1"
-        assert data["sso_bridge"]["git_ref"] == "v0.9.1"
-        assert data["sso_bridge"]["image_digest"] == "sha256:x"
-
-    def test_update_manifest_no_change(self, tmp_path: Path) -> None:
-        import json
-
-        from devx.ci.create_dependency_pr import update_manifest
-
-        p = tmp_path / "m.json"
-        p.write_text(json.dumps({"sso_bridge": {"version": "0.9.1"}}))
-        assert update_manifest(str(p), "sso_bridge", {"version": "0.9.1"}) is False
-
-    def test_update_manifest_missing_file(self, tmp_path: Path) -> None:
-        from devx.ci.create_dependency_pr import update_manifest
-
-        with pytest.raises(click.ClickException, match="not found"):
-            update_manifest(str(tmp_path / "nope.json"), "sso_bridge", {"version": "1"})
-
-    def test_update_manifest_bad_json(self, tmp_path: Path) -> None:
-        from devx.ci.create_dependency_pr import update_manifest
-
-        p = tmp_path / "m.json"
-        p.write_text("broken{")
-        with pytest.raises(click.ClickException, match="not valid JSON"):
-            update_manifest(str(p), "sso_bridge", {"version": "1"})
-
-    def test_update_manifest_missing_section(self, tmp_path: Path) -> None:
-        import json
-
-        from devx.ci.create_dependency_pr import update_manifest
-
-        p = tmp_path / "m.json"
-        p.write_text(json.dumps({"schema_version": 1}))
-        with pytest.raises(click.ClickException, match="no object section"):
-            update_manifest(str(p), "sso_bridge", {"version": "1"})
-
-
-class TestCliManifestMode:
-    @patch("devx.ci.create_dependency_pr.read_manifest_version")
-    @patch("devx.ci.create_dependency_pr.get_ci_token")
-    def test_manifest_same_version_no_pr(self, mock_token: MagicMock, mock_read: MagicMock) -> None:
-        mock_token.return_value = "fake-token"
-        mock_read.return_value = "0.9.1"
-        runner = CliRunner()
-        result = runner.invoke(
-            cli,
-            [
-                "--package",
-                "sso_bridge",
-                "--new-version",
-                "0.9.1",
-                "--source-repo",
-                "oblachno/sso-bridge",
-                "--manifest",
-                "deploy/sso-bridge-release.json",
-            ],
-        )
-        assert result.exit_code == 0
-        assert "no pr needed" in result.output.lower()
-
-    @patch("devx.ci.create_dependency_pr.resolve_container_digest")
-    @patch("devx.ci.create_dependency_pr.read_manifest_version")
-    @patch("devx.ci.create_dependency_pr.get_ci_token")
-    def test_verify_container_runs_before_lookup(
-        self, mock_token: MagicMock, mock_read: MagicMock, mock_digest: MagicMock
-    ) -> None:
-        """Verification failure aborts before the version lookup/PR steps."""
-        mock_token.return_value = "fake-token"
-        mock_digest.side_effect = click.ClickException("unpublished artifact")
-        runner = CliRunner()
-        result = runner.invoke(
-            cli,
-            [
-                "--package",
-                "sso_bridge",
-                "--new-version",
-                "0.9.1",
-                "--source-repo",
-                "oblachno/sso-bridge",
-                "--manifest",
-                "deploy/m.json",
-                "--verify-container",
-                "oblachno/sso-bridge",
-            ],
-        )
-        assert result.exit_code != 0
-        mock_read.assert_not_called()
-
-    @patch("devx.ci.create_dependency_pr.resolve_container_digest")
-    @patch("devx.ci.create_dependency_pr.read_manifest_version")
-    @patch("devx.ci.create_dependency_pr.get_ci_token")
-    def test_verify_container_resolves_digest(
-        self, mock_token: MagicMock, mock_read: MagicMock, mock_digest: MagicMock
-    ) -> None:
-        mock_token.return_value = "fake-token"
-        mock_read.return_value = "0.9.1"
-        mock_digest.return_value = "sha256:abc"
-        runner = CliRunner()
-        result = runner.invoke(
-            cli,
-            [
-                "--package",
-                "sso_bridge",
-                "--new-version",
-                "0.9.1",
-                "--source-repo",
-                "oblachno/sso-bridge",
-                "--manifest",
-                "deploy/m.json",
-                "--verify-container",
-                "oblachno/sso-bridge",
-            ],
-        )
-        assert result.exit_code == 0
-        mock_digest.assert_called_once()
-        args = mock_digest.call_args[0]
-        assert args[1:4] == ("oblachno", "sso-bridge", "0.9.1")
-
-    @patch("devx.ci.create_dependency_pr.get_ci_token")
-    def test_verify_container_invalid_format(self, mock_token: MagicMock) -> None:
-        mock_token.return_value = "fake-token"
-        runner = CliRunner()
-        result = runner.invoke(
-            cli,
-            [
-                "--package",
-                "sso_bridge",
-                "--new-version",
-                "0.9.1",
-                "--source-repo",
-                "oblachno/sso-bridge",
-                "--verify-container",
-                "no-slash",
-            ],
-        )
-        assert result.exit_code != 0
-
-    @patch("devx.ci.create_dependency_pr.resolve_container_digest")
-    @patch("devx.ci.create_dependency_pr.read_manifest_version")
-    @patch("devx.ci.create_dependency_pr.get_ci_token")
-    def test_container_tag_overrides_new_version(
-        self, mock_token: MagicMock, mock_read: MagicMock, mock_digest: MagicMock
-    ) -> None:
-        """--container-tag selects the image tag when it differs from version."""
-        mock_token.return_value = "fake-token"
-        mock_read.return_value = "0.9.1"
-        mock_digest.return_value = "sha256:abc"
-        runner = CliRunner()
-        result = runner.invoke(
-            cli,
-            [
-                "--package",
-                "sso_bridge",
-                "--new-version",
-                "0.9.1",
-                "--source-repo",
-                "oblachno/sso-bridge",
-                "--manifest",
-                "deploy/m.json",
-                "--verify-container",
-                "oblachno/sso-bridge",
-                "--container-tag",
-                "0.2.4",
-            ],
-        )
-        assert result.exit_code == 0
-        args = mock_digest.call_args[0]
-        assert args[1:4] == ("oblachno", "sso-bridge", "0.2.4")
-
-
-class TestBranchCreation:
-    """Branch creation uses the branches API (Gitea lacks POST /git/refs)."""
-
-    def _invoke(self) -> object:
-        runner = CliRunner()
-        return runner.invoke(
-            cli,
-            [
-                "--package",
-                "sso_bridge",
-                "--new-version",
-                "0.9.1",
-                "--source-repo",
-                "oblachno/sso-bridge",
-                "--manifest",
-                "deploy/m.json",
-            ],
-        )
-
-    def _client(self, mock_client_cls: MagicMock) -> MagicMock:
-        client = mock_client_cls.return_value
-        client.create_pr.return_value = {"number": 1}
-        return client
-
-    @patch("devx.ci.create_dependency_pr.create_vikunja_task", return_value=None)
-    @patch("devx.ci.create_dependency_pr.update_manifest", return_value=True)
-    @patch("devx.ci.create_dependency_pr.read_manifest_version", return_value="0.9.0")
-    @patch("devx.ci.create_dependency_pr.find_existing_pr", return_value=None)
-    @patch("devx.ci.create_dependency_pr.GiteaClient")
-    @patch("devx.ci.create_dependency_pr.get_ci_token", return_value="tok")
-    def test_creates_branch_via_branches_api(
-        self,
-        _token: MagicMock,
-        mock_client_cls: MagicMock,
-        _find: MagicMock,
-        _read: MagicMock,
-        _update: MagicMock,
-        _task: MagicMock,
-    ) -> None:
-        client = self._client(mock_client_cls)
-        result = self._invoke()
-        assert result.exit_code == 0
-        assert "Created PR" in result.output
-        post = client._request.call_args
-        assert post.args[:2] == ("POST", "/branches")
-        assert post.kwargs["json"] == {
-            "new_branch_name": "deps/sso_bridge-0.9.1",
-            "old_branch_name": "master",
-        }
-
-    @patch("devx.ci.create_dependency_pr.create_vikunja_task", return_value=None)
-    @patch("devx.ci.create_dependency_pr.update_manifest", return_value=True)
-    @patch("devx.ci.create_dependency_pr.read_manifest_version", return_value="0.9.0")
-    @patch("devx.ci.create_dependency_pr.find_existing_pr", return_value=None)
-    @patch("devx.ci.create_dependency_pr.GiteaClient")
-    @patch("devx.ci.create_dependency_pr.get_ci_token", return_value="tok")
-    def test_existing_branch_tolerated(
-        self,
-        _token: MagicMock,
-        mock_client_cls: MagicMock,
-        _find: MagicMock,
-        _read: MagicMock,
-        _update: MagicMock,
-        _task: MagicMock,
-    ) -> None:
-        from devx.exceptions import APIError
-
-        client = self._client(mock_client_cls)
-        client._request.side_effect = APIError(422, "branch already exists")
-        result = self._invoke()
-        assert result.exit_code == 0
-        assert "already exists" in result.output.lower()
-
-    @patch("devx.ci.create_dependency_pr.create_vikunja_task", return_value=None)
-    @patch("devx.ci.create_dependency_pr.update_manifest", return_value=True)
-    @patch("devx.ci.create_dependency_pr.read_manifest_version", return_value="0.9.0")
-    @patch("devx.ci.create_dependency_pr.find_existing_pr", return_value=None)
-    @patch("devx.ci.create_dependency_pr.GiteaClient")
-    @patch("devx.ci.create_dependency_pr.get_ci_token", return_value="tok")
-    def test_branch_api_error_fails(
-        self,
-        _token: MagicMock,
-        mock_client_cls: MagicMock,
-        _find: MagicMock,
-        _read: MagicMock,
-        _update: MagicMock,
-        _task: MagicMock,
-    ) -> None:
-        from devx.exceptions import APIError
-
-        client = self._client(mock_client_cls)
-        client._request.side_effect = APIError(500, "boom")
-        result = self._invoke()
-        assert result.exit_code != 0
-        assert "Failed to create branch" in result.output
-
-    @patch("devx.ci.create_dependency_pr.create_vikunja_task", return_value=None)
-    @patch("devx.ci.create_dependency_pr.update_manifest", return_value=True)
-    @patch("devx.ci.create_dependency_pr.read_manifest_version", return_value="0.9.0")
-    @patch("devx.ci.create_dependency_pr.find_existing_pr", return_value=None)
-    @patch("devx.ci.create_dependency_pr.GiteaClient")
-    @patch("devx.ci.create_dependency_pr.get_ci_token", return_value="tok")
-    def test_checks_out_remote_tracking_branch(
-        self,
-        _token: MagicMock,
-        mock_client_cls: MagicMock,
-        _find: MagicMock,
-        _read: MagicMock,
-        _update: MagicMock,
-        _task: MagicMock,
-    ) -> None:
-        import subprocess
-
-        self._client(mock_client_cls)
-        result = self._invoke()
-        assert result.exit_code == 0
-        calls = [c.args[0] for c in subprocess.run.call_args_list]
-        assert ["git", "fetch", "origin", "deps/sso_bridge-0.9.1:refs/remotes/origin/deps/sso_bridge-0.9.1"] in calls
-        assert ["git", "checkout", "-B", "deps/sso_bridge-0.9.1", "origin/deps/sso_bridge-0.9.1"] in calls
-
-    @patch("devx.ci.create_dependency_pr.create_vikunja_task", return_value="OBL-INFRA-581")
-    @patch("devx.ci.create_dependency_pr.update_manifest", return_value=True)
-    @patch("devx.ci.create_dependency_pr.read_manifest_version", return_value="0.9.0")
-    @patch("devx.ci.create_dependency_pr.find_existing_pr", return_value=None)
-    @patch("devx.ci.create_dependency_pr.GiteaClient")
-    @patch("devx.ci.create_dependency_pr.get_ci_token", return_value="tok")
-    def test_task_id_in_branch_and_spec_committed(
-        self,
-        _token: MagicMock,
-        mock_client_cls: MagicMock,
-        _find: MagicMock,
-        _read: MagicMock,
-        _update: MagicMock,
-        mock_task: MagicMock,
-    ) -> None:
-        import subprocess
-
-        client = self._client(mock_client_cls)
-        result = self._invoke()
-        assert result.exit_code == 0
-        # Branch embeds the target-repo task ID
-        post = client._request.call_args
-        assert post.kwargs["json"]["new_branch_name"] == "deps/OBL-INFRA-581-sso_bridge-0.9.1"
-        # Spec file added alongside the manifest change
-        add = next(c for c in subprocess.run.call_args_list if c.args[0][:2] == ["git", "add"])
-        assert "docs/specs/OBL-INFRA-581.md" in add.args[0]
-        # PR title carries the task ID
-        assert client.create_pr.call_args.kwargs["title"] == "OBL-INFRA-581: Bump sso_bridge to 0.9.1"
-        mock_task.assert_called_once()
-
-    def test_retries_404_until_published(self) -> None:
-        import requests
-
-        from devx.ci.create_dependency_pr import resolve_container_digest
-
-        err = requests.HTTPError("404")
-        err.response = MagicMock(status_code=404)
-        fail = MagicMock()
-        fail.raise_for_status.side_effect = err
-        ok = MagicMock()
-        ok.raise_for_status = MagicMock()
-        ok.json.return_value = [{"name": "manifest.json", "sha256": "cafe"}]
-        with (
-            patch("devx.ci.create_dependency_pr.requests.get", side_effect=[fail, ok]),
-            patch("devx.ci.create_dependency_pr.time.sleep"),
-        ):
-            digest = resolve_container_digest(
-                "https://git.example.com/api/v1", "oblachno", "sso-bridge", "0.9.1", "tok", timeout_s=60
-            )
-        assert digest == "sha256:cafe"