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

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 8

+657 -154

KofTwentyTwo commented 2026-10-15 01:17:18 +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-cdn.yaml is host-neutral and registered with HelpBundles.register(...).
• HelpBundleAssertions gates coverage, so new metadata can't merge without help.

Implementation notes (Codex):
Implemented; no commit or push.

• 124 bundle entries: app help and reusable purge help, 9 tables, 90 fields, 13 processes, 2 widgets, 8 possible-value sources. Generated purge actions receive concrete entries at registration.
• Removed deployment-specific text: kof22.com, seeded CMS rules, CMS labels/actions, backup actions, and fixed schedule claims. Preserved live references.
• Pinned QQQ to 4.1.0-RC.7 and added HOST override documentation.

Changed: pom.xml, README.md, CHANGELOG.md, CdnQBitProducer.java, CdnHelp.java, help/qbit-cdn.yaml, CdnTablesGuardrailTest.java, and new CdnHelpBundleTest.java.

./mvnw.cmd -q verify passed: 115 tests, no skips, zero Checkstyle violations; coverage 95.55% instructions and 100% classes. Bundle verified inside the JAR.

Second Brain wasn’t updated because the vault is outside writable roots.

After release, kof22 deletes help/staging/qbit-cdn.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-cdn.yaml` is host-neutral and registered with `HelpBundles.register(...)`. - `HelpBundleAssertions` gates coverage, so new metadata can't merge without help. Implementation notes (Codex): Implemented; no commit or push. - **124 bundle entries:** app help and reusable purge help, 9 tables, 90 fields, 13 processes, 2 widgets, 8 possible-value sources. Generated purge actions receive concrete entries at registration. - Removed deployment-specific text: `kof22.com`, seeded CMS rules, CMS labels/actions, backup actions, and fixed schedule claims. Preserved live references. - Pinned QQQ to **4.1.0-RC.7** and added HOST override documentation. Changed: `pom.xml`, `README.md`, `CHANGELOG.md`, `CdnQBitProducer.java`, `CdnHelp.java`, `help/qbit-cdn.yaml`, `CdnTablesGuardrailTest.java`, and new `CdnHelpBundleTest.java`. **`./mvnw.cmd -q verify` passed:** 115 tests, no skips, zero Checkstyle violations; coverage 95.55% instructions and 100% classes. Bundle verified inside the JAR. Second Brain wasn’t updated because the vault is outside writable roots. After release, kof22 deletes `help/staging/qbit-cdn.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

ux

Admin UX / information architecture

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

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: QRun-IO/qbit-cdn#24