Skip to content

retrofit: annotate openregister Bucket 1 (169 methods / 96 REQs)#1365

Merged
WilcoLouwerse merged 8 commits intofeature/reverse-specfrom
retrofit/annotate-openregister-2026-04-30
Apr 30, 2026
Merged

retrofit: annotate openregister Bucket 1 (169 methods / 96 REQs)#1365
WilcoLouwerse merged 8 commits intofeature/reverse-specfrom
retrofit/annotate-openregister-2026-04-30

Conversation

@WilcoLouwerse
Copy link
Copy Markdown
Contributor

Retrofit — Annotation Only

Applies @spec openspec/changes/retrofit-annotate-openregister-2026-04-30/tasks.md#task-N tags per ADR-003 §Spec traceability.

Ghost change: openspec/changes/archive/retrofit-annotate-openregister-2026-04-30/ (empty spec delta, 96 tasks).

Continues from retrofit-annotate-openregister-2026-04-23 which covered the bulk of the codebase. This run targets Bucket 1 methods identified in the 2026-04-30 coverage scan that were not yet annotated.

What this PR does

  • Creates ghost change with 96 tasks (one per REQ with Bucket 1 matches across 26 capabilities)
  • Adds 169 method-level @spec tags across 67 files
  • Adds file-docblock @spec tags where missing
  • Adds the annotation commit to .git-blame-ignore-revs

What this PR does NOT do

  • No logic changes
  • No formatting / whitespace / reordering
  • No Bucket 2 (see follow-up /opsx-reverse-spec PRs)
  • No Bucket 3/4 (separate follow-ups)

Bucket 1 NEEDS-REVIEW (4 entries skipped)

4 NEEDS-REVIEW entries from the coverage report were intentionally skipped — they require human verification before annotating. One of those (AuditTrailController::destroy) has been hand-reviewed and the review surfaced a real spec violation in sibling method destroyMultiple(), which is fixed in commit 763da8c on the parent branch.

Verification

  • composer phpcs passes (0 errors, 0 warnings)
  • Diff is annotations + ghost change only
  • .git-blame-ignore-revs includes the annotation commit (7334a97)

Source: openspec/coverage-report.md generated 2026-04-30

🤖 Generated with Claude Code

WilcoLouwerse and others added 7 commits April 30, 2026 13:06
…ethods

Adds pre-destruction notification REQ (objects approaching archiefactiedatum
trigger per-object Nextcloud notifications to archivaris group, configurable
lead time, deduplication via app config). Ghost change archived.

Annotates 11 Bucket 2a methods with @SPEC refs:
- DestructionCheckJob::run, sendObjectNotification → REQ-009 task
- LegalHoldService: placeHold, releaseHold, hasActiveHold,
  hasActiveHoldFromRetention, bulkPlaceHold → REQ-006 (task-5)
- ArchivalController: createLegalHold, releaseLegalHold → REQ-006 (task-5)
- ArchivalService: calculateArchivalDate → REQ-007 (task-6)
- ArchivalService: findObjectsDueForDestruction → REQ-001 (task-1)

9 private/plumbing methods in cluster left unannotated (by design).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…gnore-revs

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…Q-NNN format

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
destroyMultiple() was calling logService->deleteLogs() and returning 200,
while its sibling destroy() correctly returned 405 Method Not Allowed.
Both now enforce the audit-trail-immutable spec: audit trail entries
cannot be deleted via any route.

Also refresh coverage-report.md/.json from 2026-04-30 rescan.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Applied @SPEC tags pointing at ghost change
retrofit-annotate-openregister-2026-04-30. 96 tasks, 26 capabilities.
No logic changes. Source: openspec/coverage-report.md (2026-04-30).

Continues from retrofit-annotate-openregister-2026-04-23 which covered
the bulk of the codebase. This run adds annotations for Bucket 1
methods identified in the fresh coverage scan.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Cleanup of leftover deletions from the archive move.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@WilcoLouwerse WilcoLouwerse merged commit fef798f into feature/reverse-spec Apr 30, 2026
1 check passed
@WilcoLouwerse WilcoLouwerse deleted the retrofit/annotate-openregister-2026-04-30 branch April 30, 2026 13:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant