chore: add .claude/ to gitignore

Update pom.xml license block and header from AGPL-3.0 to Apache-2.0 to
match the LICENSE file migration in ba98f28. Add GROUP_ID, ARTIFACT_ID,
VERSION static constants to QBitProducer following standard QBit pattern.

.circleci/config.yml

@@ -1,14 +1,57 @@
 version: 2.1
-setup: true
+
 orbs:
-  qqq-orb: kingsrook/qqq-orb@0.8
+  qqq-orb: kingsrook/qqq-orb@0.5.0
+
 workflows:
-  setup:
+
+  test_only:
     jobs:
-    - qqq-orb/generate_pipeline:
-        orb_version: '0.8'
-        filters:
-          branches:
-            ignore: automation/qbit-rc-pending
-          tags:
-            only: /v.*/
+      - qqq-orb/mvn_test_only:
+          context: [ qqq-maven-registry-credentials ]
+          filters:
+            branches:
+              ignore: /(develop|main|release/.*|hotfix/.*|integration.*)/
+            tags:
+              only: []
+
+  publish_snapshot:
+    jobs:
+      - qqq-orb/mvn_publish:
+          context: [ qqq-maven-registry-credentials ]
+          branch_type: snapshot
+          filters:
+            branches:
+              only:
+                - develop
+
+  publish_release_candidate:
+    jobs:
+      - qqq-orb/mvn_publish:
+          context: [ qqq-maven-registry-credentials ]
+          branch_type: release_candidate
+          filters:
+            branches:
+              only:
+                - /release\/.*/
+
+  publish_release:
+    jobs:
+      - qqq-orb/mvn_publish:
+          context: [ qqq-maven-registry-credentials ]
+          branch_type: release
+          filters:
+            branches:
+              only: [ main ]
+            tags:
+              only: [ /v.*/ ]
+
+  publish_hotfix_release:
+    jobs:
+      - qqq-orb/mvn_publish:
+          context: [ qqq-maven-registry-credentials ]
+          branch_type: hotfix
+          filters:
+            branches:
+              only:
+                - /hotfix\/.*/

.gitea/workflows/qrun-release.yaml

@@ -1,24 +0,0 @@
-# Standard QRun release caller (v2, thin contract): every push and manual dispatch delegates to the protected qrun-release-v1 channel. Do not edit per repository.
-name: qrun-release
-on:
-  push: {}
-  workflow_dispatch: {}
-permissions:
-  contents: read
-  actions: read
-jobs:
-  release:
-    uses: self:KofTwentyTwo/platform-ci/.gitea/workflows/java-maven.yaml@qrun-release-v1
-    with:
-      runner: linux-small
-      browsers: true
-      browser-runner: browser-build
-  postpublish:
-    if: ${{ needs.release.outputs.capture == 'true' }}
-    needs: release
-    permissions:
-      contents: write
-      actions: write
-    uses: self:KofTwentyTwo/platform-ci/.gitea/workflows/qrun-source-version.yaml@qrun-release-v1
-    with:
-      runner: linux-small

.github/workflows/codeql.yml

@@ -1,23 +0,0 @@
-name: CodeQL
-'on':
-  push:
-    branches:
-    - main
-    - develop
-    - release/**
-    - hotfix/**
-  pull_request: {}
-  schedule:
-  - cron: 41 16 * * 0
-  workflow_dispatch: {}
-permissions:
-  contents: read
-  actions: read
-  security-events: write
-  packages: read
-concurrency:
-  group: codeql-${{ github.event.pull_request.number || github.ref }}
-  cancel-in-progress: ${{ github.event_name == 'pull_request' }}
-jobs:
-  analyze:
-    uses: QRun-IO/qqq-orb/.github/workflows/qbit-codeql.yml@c288a8864fe9054f68410e1d78f5863aea4c4d22

.gitignore

@@ -18,3 +18,4 @@ hs_err_pid*
 dependency-reduced-pom.xml
 /.env.local
 /.cache/
+.claude/

.qqq-ci.yml

@@ -1,16 +0,0 @@
-profile: qbit
-orb_version: '0.8'
-default_branch: develop
-java_version: '21'
-browsers: true
-api_checks: false
-docs_only: false
-release_on_main: true
-release_tag_policy: v-prefix
-test_branch_policy: feature-no-hotfix
-publish:
-  snapshot: true
-  release_candidate: true
-  release: true
-  hotfix: true
-  asciidoc: false

CONTRIBUTING.md

@@ -1,4 +1,6 @@
-# Contributing to QBit User Role Permissions
+# Contributing
 
-* See Project [Contributing](https://github.com/Kingsrook/qqq/blob/develop/CONTRIBUTING.md)
+See the QQQ project [Contributing Guide](https://github.com/Kingsrook/qqq/blob/develop/CONTRIBUTING.md) for code standards and PR workflow.
+
+For release procedures, see [RELEASING.md](RELEASING.md).
 

RELEASING.md

@@ -0,0 +1,119 @@
+# Releasing
+
+This QBit uses the [qqq-orb](https://circleci.com/developer/orbs/orb/kingsrook/qqq-orb) CircleCI orb for automated builds, versioning, and publishing to Maven Central. Releases are triggered by branch conventions -- no manual version bumping or publishing is required.
+
+## Prerequisites
+
+- CircleCI project linked to this repository
+- `qqq-maven-registry-credentials` context configured in CircleCI with:
+  - `MAVEN_USERNAME` / `MAVEN_PASSWORD` (Sonatype Central Portal)
+  - `GPG_PRIVATE_KEY_B64` / `GPG_KEYNAME` / `GPG_PASSPHRASE` (artifact signing)
+  - `GITHUB_TOKEN` (GitHub Release creation)
+
+## Branch Workflow
+
+```
+feature/my-work --> develop --> release/X.Y --> main
+                                                 \--> hotfix/X.Y.Z
+```
+
+### Development (develop branch)
+
+Every commit to `develop` publishes a **SNAPSHOT** to Maven Central.
+
+- Version format: `X.Y.Z-SNAPSHOT`
+- Consumers use this for integration testing against the latest build
+
+```bash
+# Normal development workflow
+git checkout develop
+git pull
+git checkout -b feature/my-feature
+# ... make changes, commit, push ...
+# Open PR targeting develop
+# Merge PR -> SNAPSHOT auto-publishes
+```
+
+### Release Candidate (release/* branches)
+
+When `develop` is ready for release, create a release branch. Every commit to a `release/*` branch publishes a **Release Candidate** to Maven Central.
+
+- Version format: `X.Y.Z-RC.1`, `X.Y.Z-RC.2`, etc. (auto-incremented per commit)
+- Use this for final QA and stabilization
+
+```bash
+# Create a release branch from develop
+git checkout develop
+git pull
+git checkout -b release/0.4
+git push -u origin release/0.4
+# RC.1 auto-publishes
+
+# If bug fixes are needed during QA:
+git commit -m "fix: resolve edge case in view sharing"
+git push
+# RC.2 auto-publishes (incremented automatically)
+```
+
+### Production Release (main branch)
+
+Merge the release branch into `main` to publish a **stable release**.
+
+- Version format: `X.Y.Z`
+- Automatically creates a git tag (`vX.Y.Z`) and a GitHub Release
+- Published to Maven Central as a final release artifact
+
+```bash
+# Merge release branch to main (via PR recommended)
+git checkout main
+git merge release/0.4
+git push
+
+# CI auto-creates tag v0.4.0, GitHub Release, publishes to Maven Central
+
+# After release, merge main back to develop and bump the revision
+git checkout develop
+git merge main
+# Update <revision> in pom.xml to next development version
+git commit -m "chore: bump revision to 0.5.0"
+git push
+```
+
+### Hotfix (hotfix/* branches)
+
+For critical production fixes that cannot wait for the next release cycle.
+
+- Version format: `X.Y.(Z+1)` (patch bump from current release)
+- Automatically creates a git tag and GitHub Release
+
+```bash
+# Create hotfix branch from main
+git checkout main
+git pull
+git checkout -b hotfix/0.4.1
+# ... apply fix ...
+git commit -m "fix: critical null check in view loading"
+git push -u origin hotfix/0.4.1
+# Patch release auto-publishes
+
+# Merge hotfix back to develop
+git checkout develop
+git merge hotfix/0.4.1
+git push
+```
+
+## CI/CD Configuration
+
+The release pipeline is defined in `.circleci/config.yml` and uses the `qqq-orb` to handle build, test, version calculation, and publishing. The workflows are:
+
+| Workflow | Trigger | Branch Type | Publishes |
+|----------|---------|-------------|-----------|
+| `test_only` | Push to feature/* | -- | Nothing (test only) |
+| `publish_snapshot` | Push to develop | snapshot | SNAPSHOT to Maven Central |
+| `publish_release_candidate` | Push to release/* | release_candidate | RC to Maven Central |
+| `publish_release` | Push to main | release | Stable to Maven Central + GitHub Release |
+| `publish_hotfix_release` | Push to hotfix/* | hotfix | Patch to Maven Central + GitHub Release |
+
+## Version Management
+
+The project version is controlled by the `<revision>` property in `pom.xml`. The CI pipeline reads and manipulates this value automatically based on branch type. You should only manually update `<revision>` when bumping the development version on `develop` after a release.

pom.xml

@@ -1,23 +1,22 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
   ~ QQQ - Low-code Application Framework for Engineers.
-  ~ Copyright (C) 2021-2022.  Kingsrook, LLC
+  ~ Copyright (C) 2021-2025.  QRunIO, LLC
   ~ 651 N Broad St Ste 205 # 6917 | Middletown DE 19709 | United States
   ~ contact@kingsrook.com
-  ~ https://github.com/Kingsrook/
+  ~ https://github.com/QRun-IO/
   ~
-  ~ This program is free software: you can redistribute it and/or modify
-  ~ it under the terms of the GNU Affero General Public License as
-  ~ published by the Free Software Foundation, either version 3 of the
-  ~ License, or (at your option) any later version.
+  ~ Licensed under the Apache License, Version 2.0 (the "License");
+  ~ you may not use this file except in compliance with the License.
+  ~ You may obtain a copy of the License at
   ~
-  ~ This program is distributed in the hope that it will be useful,
-  ~ but WITHOUT ANY WARRANTY; without even the implied warranty of
-  ~ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-  ~ GNU Affero General Public License for more details.
+  ~     http://www.apache.org/licenses/LICENSE-2.0
   ~
-  ~ You should have received a copy of the GNU Affero General Public License
-  ~ along with this program.  If not, see <https://www.gnu.org/licenses/>.
+  ~ Unless required by applicable law or agreed to in writing, software
+  ~ distributed under the License is distributed on an "AS IS" BASIS,
+  ~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  ~ See the License for the specific language governing permissions and
+  ~ limitations under the License.
   -->
 
   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
@@ -30,7 +29,7 @@
 
    <groupId>com.kingsrook.qbits</groupId>
    <artifactId>qbit-customizable-table-views</artifactId>
-   <version>${revision}</version>
+   <version>0.4.0-SNAPSHOT</version>
    <packaging>jar</packaging>
 
    <name>QBit Customizable Table Views</name>
@@ -41,8 +40,8 @@
 
    <licenses>
       <license>
-         <name>GNU Affero General Public License v3.0</name>
-         <url>https://www.gnu.org/licenses/agpl-3.0.html</url>
+         <name>Apache License, Version 2.0</name>
+         <url>https://www.apache.org/licenses/LICENSE-2.0</url>
          <distribution>repo</distribution>
       </license>
    </licenses>
@@ -65,7 +64,7 @@
    </scm>
 
    <properties>
-      <revision>0.4.0</revision>
+      <revision>0.4.0-SNAPSHOT</revision>
    </properties>
 
    <dependencyManagement>
@@ -73,7 +72,7 @@
          <dependency>
             <groupId>com.kingsrook.qqq</groupId>
             <artifactId>qqq-bom-pom</artifactId>
-            <version>0.40.0</version>
+            <version>0.40.0-SNAPSHOT</version>
             <type>pom</type>
             <scope>import</scope>
          </dependency>

src/main/java/com/kingsrook/qbits/customizabletableviews/CustomizableTableViewsQBitProducer.java

@@ -41,6 +41,10 @@ import com.kingsrook.qqq.backend.core.model.metadata.qbits.QBitMetaDataProducer;
  *******************************************************************************/
 public class CustomizableTableViewsQBitProducer implements QBitMetaDataProducer<CustomizableTableViewsQBitConfig>
 {
+   public static final String GROUP_ID    = "com.kingsrook.qbits";
+   public static final String ARTIFACT_ID = "customizable-table-views";
+   public static final String VERSION     = "0.4.0";
+
    private CustomizableTableViewsQBitConfig customizableTableViewsQBitConfig;
 
 
@@ -52,9 +56,9 @@ public class CustomizableTableViewsQBitProducer implements QBitMetaDataProducer<
    public QBitMetaData getQBitMetaData()
    {
       QBitMetaData qBitMetaData = new QBitMetaData()
-         .withGroupId("com.kingsrook.qbits")
-         .withArtifactId("customizable-table-views")
-         .withVersion("0.1.0")
+         .withGroupId(GROUP_ID)
+         .withArtifactId(ARTIFACT_ID)
+         .withVersion(VERSION)
          .withNamespace(getNamespace())
          .withConfig(getQBitConfig());