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

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

Merged
WilcoLouwerse merged 8 commits into
feature/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 into
feature/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 subscribe to this conversation on GitHub. Already have an account? Sign in.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant