Repository navigation
Non-functional requirements baseline (ARCHITECT role, MCP, screenshots) - #2
Merged
Merged
Conversation
Global NFRs (BL-01, ...) with a category such as performance, availability, security or usability. Every project shows them as read-only items: in the side navigation, on the overview next to its own NFRs, in the read view and in the PRD export. They are not part of project snapshots, so adding, changing or removing one never changes a project's state, content hash or approved versions. PDF cache keys include a baseline fingerprint so cached exports follow changes. Only users with the application role ARCHITECT edit the baseline. It is mapped at sign-in from an IDP roles claim: REQLITH_IDP_ROLES_CLAIM (default "roles", dotted names reach nested claims) and REQLITH_IDP_ARCHITECT_ROLES (default ARCHITECT). The local realm gets the realm role ARCHITECT, a mapper that puts realm roles into the ID token's "roles" claim, and the test user architect1. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
New tool list_baseline_requirements (filter by category and text). get_prd includes the baseline like the PRD export, search_requirements returns matching baseline items (project "baseline") unless the type excludes NFRs, and get_requirement accepts BL- keys with any project key. The server instructions tell agents the baseline applies to every project. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…eline Recaptured from four sample projects seeded through the app as the test users: overview and requirement in the usual "Draft after v1" state, review and compare on an open v2-rc1 review, plus the projects home page and the NFR baseline. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
NFR baseline: global non-functional requirements (
BL-01, …) with a category (performance, availability, security, usability, …), managed from a new Baseline button next to Workspaces.BL-keys stay retired, like element keys.ARCHITECT role: only architects edit the baseline. The service enforces this and returns 403 otherwise.
REQLITH_IDP_ROLES_CLAIM(defaultroles; dotted names such asrealm_access.rolesreach nested claims) andREQLITH_IDP_ARCHITECT_ROLES(defaultARCHITECT, comma-separated, case-insensitive).ARCHITECT, a mapper that puts realm roles into the ID token'srolesclaim, and the test userarchitect1/password.ARCHITECT).MCP:
list_baseline_requirements(filter by category and text).get_prdincludes the baseline.search_requirementsreturns matching baseline items (project"baseline") unless the type excludes NFRs.get_requirementacceptsBL-keys with any project key.README screenshots: recaptured from four sample projects. Overview and requirement show the usual "Draft after v1" state, review and compare show an open v2-rc1 review, and two images are new: the projects home page and the baseline.
Notes for reviewers
V7__nfr_baseline.sqladds thebaseline_requirementtable.podman rm -f reqlith-keycloak, thensrc/main/dev/scripts/podman-dev.sh up).BL-keys are still reported as broken references.Test plan
src/main/dev/scripts/test.sh verify: 152 tests pass. New:BaselineServiceIT,BaselinePagesIT,ProvisioningOidcUserServiceTest, the baseline case inMcpServerIT, plus additions toIdpClaimsTest,PrdMarkdownWriterTestandExportServiceTest.architect1containsroles: [..., ARCHITECT];owner1's does not.architect1shows the add form on/baseline;owner1sees the baseline read-only.🤖 Generated with Claude Code