QRun-IO/qbit-authentik
3
0 Fork 0
Code Issues Pull Requests 6 Actions Packages Projects Releases 8 Wiki Activity

feat(help): qbit-authentik help bundle via QQQ help bundles, with coverage gate #34

Merged
KofTwentyTwo merged 1 commits from feature/help-bundle into develop 2026-10-15 01:29:38 +00:00
Conversation 0 Commits 1 Files Changed 12
+1165 -221
KofTwentyTwo commented 2026-10-15 01:17:08 +00:00 (Migrated from github.com)
Copy link
Copy source

Moves this qbit's in-app help out of kof22's staging bundle and into the qbit as a QQQ help bundle (qqq docs/HELP-CONTENT.md section 5, QQQ 4.1.0-RC.7).

  • src/main/resources/help/qbit-authentik.yaml is host-neutral and registered with HelpBundles.register(...).
  • HelpBundleAssertions gates coverage, so new metadata can't merge without help.

Implementation notes (Codex):
Implemented without committing or pushing.

  • 296 help entries covering 1 app, 15 tables, 30 processes, 13 widgets, 4 possible-value sources, plus fields and sections.
  • Removed kof22 site/admin-group claims, token-action unavailability, and fixed cache/session-refresh assumptions.
  • Pinned QQQ to 4.1.0-RC.7, registered the bundle, preserved custom prefixes, and migrated expired token compatibility shims.

./mvnw.cmd -q verify passed: 299 tests, repository guardrails, 92.5% instruction / 100% class coverage. Docker unavailable: 55 contract tests skipped.

Files changed:

  • pom.xml, README.md, CHANGELOG.md
  • help/qbit-authentik.yaml
  • AuthentikQBitProducer.java, AuthentikHelp.java
  • TokenKeyDelivery.java, AuthentikTokenScopes.java
  • AuthentikHelpBundleTest.java, AuthentikTablesGuardrailTest.java
  • TokenManagementTest.java, TokenScopesTest.java

Vault writes were restricted; the handoff note is saved in cache.

After release, kof22 deletes help/staging/qbit-authentik.yaml.

🤖 Generated with Claude Code

Moves this qbit's in-app help out of kof22's staging bundle and into the qbit as a QQQ help bundle (qqq `docs/HELP-CONTENT.md` section 5, QQQ 4.1.0-RC.7). - `src/main/resources/help/qbit-authentik.yaml` is host-neutral and registered with `HelpBundles.register(...)`. - `HelpBundleAssertions` gates coverage, so new metadata can't merge without help. Implementation notes (Codex): Implemented without committing or pushing. - **296 help entries** covering 1 app, 15 tables, 30 processes, 13 widgets, 4 possible-value sources, plus fields and sections. - Removed kof22 site/admin-group claims, token-action unavailability, and fixed cache/session-refresh assumptions. - Pinned QQQ to **4.1.0-RC.7**, registered the bundle, preserved custom prefixes, and migrated expired token compatibility shims. `./mvnw.cmd -q verify` passed: **299 tests**, repository guardrails, **92.5% instruction / 100% class coverage**. Docker unavailable: 55 contract tests skipped. Files changed: - `pom.xml`, `README.md`, `CHANGELOG.md` - `help/qbit-authentik.yaml` - `AuthentikQBitProducer.java`, `AuthentikHelp.java` - `TokenKeyDelivery.java`, `AuthentikTokenScopes.java` - `AuthentikHelpBundleTest.java`, `AuthentikTablesGuardrailTest.java` - `TokenManagementTest.java`, `TokenScopesTest.java` Vault writes were restricted; the [handoff note](C:/Users/james/.cache/qbit-authentik-help-session.md) is saved in cache. After release, kof22 deletes `help/staging/qbit-authentik.yaml`. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
Clear labels
architecture
Architecture review: coupling, cohesion, UI API
 bug
Something isn't working
 dependencies
documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 github_actions
Pull requests that update GitHub Actions code
 good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 java
Pull requests that update java code
 question
Further information is requested
 release:rc
Merging this develop PR cuts the next release candidate
 secuurity
wontfix
This will not be worked on
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
forge-recovery (Forge Recovery) james.maes (James Maes)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: QRun-IO/qbit-authentik#34