Skip to content
This repository was archived by the owner on May 29, 2026. It is now read-only.

retrofit: annotate 70 backend methods to zero spec-coverage gaps#68

Merged
rubenvdlinde merged 1 commit into
developmentfrom
retrofit/coverage-to-zero-app-versions
May 25, 2026
Merged

retrofit: annotate 70 backend methods to zero spec-coverage gaps#68
rubenvdlinde merged 1 commit into
developmentfrom
retrofit/coverage-to-zero-app-versions

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Retrofit — Spec Coverage Annotation

Drives gate-16 spec-coverage for app-versions from 70 uncovered backend methods → 0.

What this PR does

  • Adds @spec openspec/specs/<capability>/spec.md docblock tags to all 70 in-scope Controller / Service / Listener methods.
  • Each method maps to one of the four existing capability specs:
    • version-management — installed-apps list, version fetch, install (signed path), finalizer, page shell
    • external-sources — source abstraction/registry/binding, trusted-source allowlist, GitHub release source, external installer
    • pat-management — PAT storage/validation/encryption, resolver, deeplink, user-deletion sweep
    • app-discovery — provider interface, App Store / GitHub-private / GitHub-search providers, aggregator
  • No new REQs were minted — the four specs already describe every method's observed behaviour, so this is annotation-only.

What this PR does NOT do

  • No code behaviour changes — docblock additions only.
  • No @spec exclude markers — every worklist method is a true capability covered by an existing REQ.

Verification

  • csc.py --mode report -> uncovered_count: 0
  • php -l clean on all 26 changed files

Source: gate-16 spec-coverage report (app-versions worklist, 2026-05-25).

Maps all 70 uncovered Controller/Service/Listener methods to the four
existing capability specs (version-management, external-sources,
pat-management, app-discovery) via @SPEC docblock tags. No new REQs were
needed — the specs already describe every method's behaviour. Drives
gate-16 spec-coverage to 0 uncovered backend methods.
@rubenvdlinde rubenvdlinde added openspec OpenSpec-driven change yolo Auto-merge when all phases pass labels May 25, 2026
@rubenvdlinde rubenvdlinde merged commit 2981dfe into development May 25, 2026
4 of 18 checks passed
@rubenvdlinde rubenvdlinde deleted the retrofit/coverage-to-zero-app-versions branch May 25, 2026 20:10
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/app-versions @ ce6a23f

Check PHP Vue Security License Tests
lint
phpcs
phpmd
psalm
phpstan
phpmetrics
eslint
stylelint
composer
npm ✅ 282/282
PHPUnit ⏭️
Newman ⏭️
Playwright ⏭️

Quality workflow — 2026-05-25 20:10 UTC

Download the full PDF report from the workflow artifacts.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

openspec OpenSpec-driven change yolo Auto-merge when all phases pass

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant