Skip to content

docs(specs): fix Ketryx itemId cross-references in two SPEC files [PYSDK-121]#617

Open
helmut-hoffer-von-ankershoffen wants to merge 1 commit intomainfrom
feat/PYSDK-121-doc-drift-remediation-ketryx-item-ids
Open

docs(specs): fix Ketryx itemId cross-references in two SPEC files [PYSDK-121]#617
helmut-hoffer-von-ankershoffen wants to merge 1 commit intomainfrom
feat/PYSDK-121-doc-drift-remediation-ketryx-item-ids

Conversation

@helmut-hoffer-von-ankershoffen
Copy link
Copy Markdown
Contributor

@helmut-hoffer-von-ankershoffen helmut-hoffer-von-ankershoffen commented May 1, 2026

🛡️ Implements PYSDK-121 following CC-SOP-01 Change Control, part of our ISO 13485-certified QMS | Ketryx Project

Summary

  • SPEC-LAUNCHPAD-STATUS-PAGE.md: itemIsRelatedTo used underscore-based filename stems (SPEC_GUI_SERVICE, SPEC_PLATFORM_SERVICE, SPEC_SYSTEM_SERVICE) instead of the canonical hyphen-based itemId values (SPEC-GUI-SERVICE, SPEC-PLATFORM-SERVICE, SPEC-SYSTEM-SERVICE). Introduced in feat(launchpad): conditional Betterstack status page per environment [PYSDK-107] #599. Ketryx traceability links were broken.
  • SPEC-UTILS-SERVICE.md: itemFulfills ended with SWR_SYSTEM_CLI_HEALTH_1, SWR_SYSTEM_GUI_HEALTH_1, SWR_SYSTEM_GUI_SETTINGS_1 (underscore form) instead of SWR-SYSTEM-CLI-HEALTH-1, SWR-SYSTEM-GUI-HEALTH-1, SWR-SYSTEM-GUI-SETTINGS-1 (correct hyphen itemId form). Pre-existing since 2025-11-03. These three SWRs were invisible to Ketryx traceability from this SPEC.

No functional code change. Documentation (Ketryx metadata) only.

Test plan

  • Automated checks pass (CI green)
  • SonarCloud: 0 new issues on this PR

Posted by Claude claude-sonnet-4-6 via Claude Code, applying skill documentation-drift on behalf of Helmut Hoffer von Ankershoffen

…erscores [PYSDK-121]

Two specification files referenced Ketryx item IDs using the filename
stem (underscore-separated) rather than the canonical itemId value
(hyphen-separated), preventing Ketryx from resolving the traceability links.

- SPEC-LAUNCHPAD-STATUS-PAGE.md: itemIsRelatedTo used SPEC_GUI_SERVICE,
  SPEC_PLATFORM_SERVICE, SPEC_SYSTEM_SERVICE → corrected to SPEC-GUI-SERVICE,
  SPEC-PLATFORM-SERVICE, SPEC-SYSTEM-SERVICE.
- SPEC-UTILS-SERVICE.md: itemFulfills appended SWR_SYSTEM_CLI_HEALTH_1,
  SWR_SYSTEM_GUI_HEALTH_1, SWR_SYSTEM_GUI_SETTINGS_1 → corrected to
  SWR-SYSTEM-CLI-HEALTH-1, SWR-SYSTEM-GUI-HEALTH-1, SWR-SYSTEM-GUI-SETTINGS-1.

No functional code change. Documentation only.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings May 1, 2026 07:12
@helmut-hoffer-von-ankershoffen helmut-hoffer-von-ankershoffen requested a review from a team as a code owner May 1, 2026 07:12
@sonarqubecloud
Copy link
Copy Markdown

sonarqubecloud Bot commented May 1, 2026

Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Fixes Ketryx/QMS traceability metadata in existing SPEC documents by correcting cross-references to use canonical hyphenated itemId values (instead of underscore/filename stems), restoring proper linkage in Ketryx without any functional code changes.

Changes:

  • Update SPEC-LAUNCHPAD-STATUS-PAGE itemIsRelatedTo to reference canonical hyphenated SPEC itemIds.
  • Update SPEC-UTILS-SERVICE itemFulfills to reference canonical hyphenated SWR itemIds.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
specifications/SPEC-UTILS-SERVICE.md Fixes itemFulfills SWR references from underscore form to canonical hyphenated itemIds.
specifications/SPEC-LAUNCHPAD-STATUS-PAGE.md Fixes itemIsRelatedTo references from underscore/filename stems to canonical hyphenated SPEC itemIds.

@codecov
Copy link
Copy Markdown

codecov Bot commented May 1, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.
see 6 files with indirect coverage changes

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants