Skip to content

chore(specs): audit+remediate retrofit REQs — group 5 (service facades) - #1902

Merged
rubenvdlinde merged 1 commit into
developmentfrom
chore/req-audit-audit-5-2026-05-25
May 25, 2026
Merged

rubenvdlinde merged 1 commit into
developmentfrom
chore/req-audit-audit-5-2026-05-25

Conversation

@rubenvdlinde

Copy link
Copy Markdown
Contributor

Summary

Deep-audit + remediation of 3 retrofit service-facade changes (14 REQs total) to /opsx-ff quality. Annotation-only spec deltas; no runtime code changes.

  • bw2-svc-flat-1 (5 REQs: datetime-input-handling, files-sidebar-tabs, generic-integrations, webhook-payload-mapping, zoeken-filteren) — already ADR-037 Form A and well-structured; no edits needed.
  • bw2-svc-flat-2 (5 REQs: activity-provider, audit-trail-immutable, generic-integrations, search-index, text-extraction) — converted all 5 requirement headings from Form B (REQ-XX prefix + full-sentence MUST) to Form A (concise noun-phrase title; MUST retained in the body first line). Synced tasks.md + proposal.md anchors. Clarified text-extraction's layering relative to the sibling text-extraction-sources handler cap.
  • bw2-svc-flat-3 (4 REQs, 2 NEW caps: schema-property-exploration, file-risk-classification) — added ## Why scoping + retrofit: true frontmatter to both new-cap spec files (extra-scrutiny per new-capability rubric).

Audit findings

  • All three changes pass openspec validate --strict.
  • Form A is now consistent across the group (matches the cleaner fleet siblings).
  • Cross-change flag: text-extraction (this group) and text-extraction-sources (bw-svc-mid2, not in this PR) are complementary layers, not duplicates — see recommendation in the linked audit thread. No unilateral merge performed.

Test plan

  • openspec validate retrofit-2026-05-25-bw2-svc-flat-1 --strict
  • openspec validate retrofit-2026-05-25-bw2-svc-flat-2 --strict
  • openspec validate retrofit-2026-05-25-bw2-svc-flat-3 --strict

Convert bw2-svc-flat-2 requirement headings from Form B (REQ-ID prefix +
sentence) to ADR-037 Form A (concise title, MUST stays in body first line);
sync tasks.md anchors. Clarify text-extraction's relationship to the sibling
text-extraction-sources handler cap. Add Why + retrofit frontmatter to the
two new bw2-svc-flat-3 capabilities (schema-property-exploration,
file-risk-classification). bw2-svc-flat-1 already conformant.
@rubenvdlinde
rubenvdlinde requested a review from Rem-Dam as a code owner May 25, 2026 16:37
@rubenvdlinde
rubenvdlinde merged commit fbc4ac2 into development May 25, 2026
15 of 20 checks passed
@rubenvdlinde
rubenvdlinde deleted the chore/req-audit-audit-5-2026-05-25 branch May 25, 2026 16:38
@github-actions

Copy link
Copy Markdown
Contributor

Quality Report — ConductionNL/openregister @ 9ed1ec7

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

Quality workflow — 2026-05-25 16:40 UTC

Download the full PDF report from the workflow artifacts.

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

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant